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Preface 


The HP TCP/IP Services for OpenVMS product is the HP implementation of the 
TCP/IP networking protocol suite and internet services for HP OpenVMS Alpha 
systems. 


TCP/IP Services provides a comprehensive suite of functions and applications that 
support industry-standard protocols for heterogeneous network communications 
and resource sharing. 


This manual describes the TCP/IP Services management commands. Use it in 
conjunction with the HP TCP/IP Services for OpenVMS Management manual, 
which describes the management tasks. 


Refer to the HP TCP/IP Services for OpenVMS Installation and Configuration 
manual for information about installing, configuring, and starting this product. 


Intended Audience 


This manual is for experienced OpenVMS and UNIX® system managers and 
assumes a working knowledge of OpenVMS system management, TCP/IP 
networking, and TCP/IP terminology. 


If you are not familiar with the TCP/IP Services product, please review the 

Compaq TCP/IP Services for OpenVMS Concepts and Planning manual before 

using this manual to configure and manage TCP/IP components. 
Document Structure 

This manual contains the following chapters: 

e Chapter 1 introduces the management control program. 


e Chapter 2 provides command descriptions for each management command. 


Related Documents 
Table 1 lists the documents available with this version of TCP/IP Services. 
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Table 1 TCP/IP Services Documentation 


Manual 


Contents 


Compaq TCP/IP Services for OpenVMS 


Concepts and Planning 


HP TCP/IP Services for OpenVMS 
Release Notes 


HP TCP/IP Services for OpenVMS 
Installation and Configuration 


HP TCP/IP Services for OpenVMS 
User’s Guide 


HP TCP/IP Services for OpenVMS 
Management 


HP TCP/IP Services for OpenVMS 
Management Command Reference 


HP TCP/IP Services for OpenVMS 
Management Command Quick 
Reference Card 


HP TCP/IP Services for OpenVMS 


UNIX Command Equivalents Reference 


Card 


Compaq TCP/IP Services for OpenVMS 


ONC RPC Programming 


Compaq TCP/IP Services for OpenVMS 


Sockets API and System Services 
Programming 


Compaq TCP/IP Services for OpenVMS 


SNMP Programming and Reference 


viii 


This manual provides conceptual information about TCP/IP 
networking on OpenVMS systems, including general planning 
issues to consider before configuring your system to use the 
TCP/IP Services software. 


This manual also describes the manuals in the TCP/IP Services 
documentation set and provides a glossary of terms and 
acronyms for the TCP/IP Services software product. 


The release notes provide version-specific information that 
supersedes the information in the documentation set. The 
features, restrictions, and corrections in this version of the 
software are described in the release notes. Always read the 
release notes before installing the software. 


This manual explains how to install and configure the TCP/IP 
Services product. 


This manual describes how to use the applications available with 
TCP/IP Services such as remote file operations, email, TELNET, 
TN3270, and network printing. 


This manual describes how to configure and manage the TCP/IP 
Services product. 


This manual describes the TCP/IP Services management 
commands. 


This reference card lists the TCP/IP management commands by 
component and describes the purpose of each command. 


This reference card contains information about commonly 
performed network management tasks and their corresponding 
TCP/IP management and Tru64 UNIX command formats. 


This manual presents an overview of high-level programming 
using open network computing remote procedure calls (ONC 
RPCs). This manual also describes the RPC programming 
interface and how to use the RPCGEN protocol compiler to create 
applications. 


This manual describes how to use the Sockets API and OpenVMS 
system services to develop network applications. 


This manual describes the Simple Network Management Protocol 
(SNMP) and the SNMP application programming interface 
(eSNMP). It describes the subagents provided with TCP/IP 
Services, utilities provided for managing subagents, and how to 
build your own subagents. 


(continued on next page) 


Table 1 (Cont.) TCP/IP Services Documentation 


Manual 


Contents 


HP TCP/IP Services for OpenVMS 
Tuning and Troubleshooting 


HP TCP/IP Services for OpenVMS 
Guide to IPv6 


HP TCP/IP Services for OpenVMS 
Guide to SSH 


This manual provides information about how to isolate the 
causes of network problems and how to tune the TCP/IP Services 
software for the best performance. 


This manual describes the IPv6 environment, the roles of 
systems in this environment, the types and function of the 
different IPv6 addresses, and how to configure TCP/IP Services 
to access the IPv6 network. 


This manual describes the way Secure Shell (SSH) is 
implemented on TCP/IP Services. It describes how to configure, 
manage, and use the optional services that are protected by 
secure shell security. 


For additional information about HP OpenVMS products and services, visit the 
following World Wide Web address: 


http: //www.hp.com/go/openvms 


For a comprehensive overview of the TCP/IP protocol suite, refer to the book 
Internetworking with TCP/IP: Principles, Protocols, and Architecture, by Douglas 


Comer. 


Reader’s Comments 


HP welcomes your comments on this manual. Please send comments to either of 
the following addresses: 


Internet 
Postal Mail 


openvmsdoc@hp.com 


Hewlett-Packard Company 

OSSG Documentation Group, ZKO3-4/U08 
110 Spit Brook Rd. 

Nashua, NH 03062-2698 


How to Order Additional Documentation 


For information about how to order additional documentation, visit the following 
World Wide Web address: 


http: //www.hp.com/go/openvms/doc/order 


Conventions 


IP addresses in this manual are fictitious. The following conventions may be used 


in this manual. 


Ctrl/x 


PF1 x 


A sequence such as Ctrl/x indicates that you must hold down 
the key labeled Ctrl while you press another key or a pointing 
device button. 


A sequence such as PF 1 x indicates that you must first press 
and release the key labeled PF1 and then press and release 
another key or a pointing device button. 


Return 


() 


{} 


bold type 


italic type 


Example 


UPPERCASE TYPE 


numbers 


In examples, a key name enclosed in a box indicates that 
you press a key on the keyboard. (In text, a key name is not 
enclosed in a box.) 


In the HTML version of this document, this convention appears 
as brackets, rather than a box. 


A horizontal ellipsis in examples indicates one of the following 
possibilities: 


e Additional optional arguments in a statement have been 
omitted. 


e The preceding item or items can be repeated one or more 
times. 


e Additional parameters, values, or other information can be 
entered. 


A vertical ellipsis indicates the omission of items from a code 
example or command format; the items are omitted because 
they are not important to the topic being discussed. 


In command format descriptions, parentheses indicate that you 
must enclose choices in parentheses if you specify more than 
one. 


In command format descriptions, brackets indicate optional 
choices. You can choose one or more items or no items. 

Do not type the brackets on the command line. However, 
you must include the brackets in the syntax for OpenVMS 
directory specifications and for a substring specification in an 
assignment statement. 


In command format descriptions, vertical bars separate choices 
within brackets or braces. Within brackets, the choices are 
optional; within braces, at least one choice is required. Do not 
type the vertical bars on the command line. 


In command format descriptions, braces indicate required 
choices; you must choose at least one of the items listed. Do 
not type the braces on the command line. 


Bold type represents the introduction of a new term. It also 
represents the name of an argument, an attribute, or a reason. 


Italic type indicates important information, complete titles 
of manuals, or variables. Variables include information that 
varies in system output (Internal error number), in command 
lines (PRODUCER=name), and in command parameters in 
text (where dd represents the predefined code for the device 
type). 


This typeface indicates code examples, command examples, and 
interactive screen displays. In text, this type also identifies 
URLs, UNIX commands and pathnames, PC-based commands 
and folders, and certain elements of the C programming 
language. 


Uppercase type indicates a command, the name of a routine, 
the name of a file, or the abbreviation for a system privilege. 


A hyphen at the end of a command format description, 
command line, or code line indicates that the command or 
statement continues on the following line. 


All numbers in text are assumed to be decimal unless 
otherwise noted. Nondecimal radixes—binary, octal, or 
hexadecimal—are explicitly indicated. 
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Using TCP/IP Services Management 
Commands 


The TCP/IP Services product provides a management command interface you 
use to configure and manage the software. These commands let you perform the 
following tasks: 


e Configure and reconfigure components 

e Modify parameters of components 

e Configure customer-developed services 

e Enable and disable running components 


e Monitor the running software 


1.1 Entering Commands 


To start the management control program, type TCPIP at the DCL prompt. For 
example: 


$ TCPIP 
TCPIP> 


At the TCPIP> prompt, you can enter commands described in this manual or 
display online help. Type EXIT to exit the management control program, or press 
Ctrl/C to abort a command. 


Help is also available at the DCL prompt by typing HELP TCPIP_SERVICES. 
$ HELP TCPIP_ SERVICES 


Note 


The word command refers to commands for the TCP/IP Services 
software. DCL commands and UNIX commands are explicitly identified. 


Table 1-1 provides guidelines for using management control program 
commands. 
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Table 1-1 Management Command Guidelines 


Element Guideline 


Address formats Some commands require that you specify one of the following 
kinds of addresses: 


e IP 
e Ethernet 
e FDDI 


e Token Ring 
e Hardware 


Be sure to use the appropriate format. The following examples 
illustrate an IP address, an Ethernet address, and a hardware 
address, respectively. 


TCPIP> SET HOST CROW /ADDRESS=1.2.3.4 
TCPIP> SET ARP AA-BB-04-05-06-07 CONDOR 
TCPIP> SET BOOTP MACAW /HARDWARE=ADDRESS=08-dd-ff-2a-23-21 


Default Refers to the command’s behavior if optional qualifiers are 
omitted. 
File and directory names When you specify OpenVMS files, follow all OpenVMS file 


specification rules. Likewise, when you specify UNIX files, 
follow all UNIX file specification rules. 


Service names To specify a lowercase or mixed-case service name, enclose it in 
quotation marks. Service names are limited to 16 characters. 
Use only the following characters in a service name: 


e Uppercase and lowercase alphabetic characters 
e Numerals 

e Dollar sign ($) 

e Underscore (_) 


Do not define a service name equivalent to one of the TCP/IP 
Services for OpenVMS components (for example, do not define 
a service name BIND or TCPIP$BIND). In addition, the service 
name CUSTOMER SERVICE is reserved by HP. 


Host names and IP addresses To specify a host or network name on a command line, you can 
enter either the host’s name or the host’s IP address. 


Keywords You can abbreviate commands to the fewest number of 
characters, usually four, that identify the command. The 
following command lines, for example, have identical meanings: 


TCPIP> SH SE NFS/FU/PER 


TCPIP> SHOW SERVICE NFS /FULL /PERMANENT 


Command examples shown in this manual are expressed using 
full command and qualifier names for clarity. 


(continued on next page) 
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Table 1-1 (Cont.) Management Command Guidelines 


Element 


Guideline 


Multiple values 


Numeric values 


To specify multiple host names, addresses, or options for 
parameters and qualifiers, be sure to separate elements with 
commas and enclose the entire list in parentheses. Wildcards 
are valid unless otherwise stated. A space between multiple 
elements is optional unless otherwise stated. For example, the 
following qualifiers are the same: 


/qualifier=(option_a:valuel,option_b:value2,value3) 


/qualifier=(option_a=valuel), (option_b=value2,value3) 


Wildcards are valid unless otherwise stated. A space between 
multiple elements is optional unless otherwise stated. 


Unless otherwise stated, all numeric values are decimal. Values 
are indicated by either a preceding equals sign (=) or a colon (:). 
For example: 


TCPIP> SET NAME SERVICE /SERVER: (SORA, JACANA, PARROT) - 
_TCPIP> /ACCEPT: (HOSTS: JACANA, JAY, JUNCO,999.20.40.3) 


(continued on next page) 
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Table 1-1 (Cont.) Management Command Guidelines 


Element Guideline 


Quotation marks In command lines, enclose the following in quotation marks: 


e Lowercase and mixed-case names to be stored in a 
database with the exact case preserved 


e Directory and file specifications containing a slash (/) 
e Uppercase options specified with UNIX commands 
Consider these examples: 

1. To specify a path, enclose it in quotation marks: 
TCPIP> MAP "/usr/songbirds/canary" CANARYSDUA2: 


2. To specify host names using lowercase letters when you 
create a proxy entry in the database: 


TCPIP> ADD PROXY COUSINS /GID=10 /UID=40 - 
_TCPIP> /HOST=("raven","crow", "rook", "daw" ) 


Note the use of the DCL command-line continuation 
character ( - ) that allows you to continue a long command 
on the next line. 


3. To specify a lowercase host name when adding the host to 
the hosts database, use these commands: 


TCPIP> SET HOST "eaglet" /ADDRESS = 128.33.22.1 
TCPIP> SHOW HOST EAGLET 


Note that DCL interprets all input as uppercase unless 
you enclose it in quotation marks. Therefore, you must use 
quotation marks to enter the host name in lowercase in the 
hosts database. To display information about a host, you 
can enter either uppercase or lowercase characters. 


4. When entering a lowercase or mixed-case service name in 
a command, enclose it in quotations marks. For example: 


TCPIP> SET SERVICE "hello" ... 


5. When entering an option in uppercase in a UNIX 
command, enclose the option in quotation marks. For 
example: 


TCPIP> sysconfig "-Q" inet 


(continued on next page) 
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Table 1-1 (Cont.) Management Command Guidelines 


Element Guideline 

UNIX commands Follow UNIX syntax and case rules when entering UNIX 
commands at the DCL and TCPIP> prompts. For example, 
enter the ifconfig command in lowercase letters: 
TCPIP> ifconfig options 
When entering UNIX commands at the DCL or TCPIP> 
prompt, enclose uppercase options in quotation marks. For 
example: 
$ TCPIP> sysconfig "-Q" inet 
You can abbreviate commands, as shown in the following 
example. The abbreviation must be unique through the first 
four characters. 
TCPIP> ifco options 
If the abbreviation entered is not unique, an error message will 
advise you to supply more characters. In the following example, 
the SYSCONFIG command cannot be abbreviated because of 
the SYSCONFIGDB command. 
TCPIP> sysc -q 

%CLI-W-ABVERB, ambiguous command verb - 

supply more characters 

Wildcards If you specify a wildcard (an asterisk [*]) on a command line, 


you are asked for confirmation before the command executes. 
For example: 


TCPIP> REMOVE PROXY * 
VMS User_name Type User_ID Group ID Host_name 


GRACKLE N 269 48 MAPLE 
Remove? [N]: 


To change this default behavior (so that you are not asked to 
confirm), use the /NOCONFIRM qualifier with the command. 


1.1.1 Setting Configuration Parameters 


Some commands allow you to enter information in the database; others modify 


only the run-time parameters. Table 1-2 shows the SET commands that affect 


one or the other. 
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Table 1-2 SET Commands 


Modify Permanent Database Files Modify Dynamic Memory 
SET BOOTP SET ARP 

SET CONFIGURATION SET COMMUNICATION 
SET HOST SET INTERFACE 

SET MX_RECORDS SET NAME_SERVICE 
SET NETWORK SET NFS_SERVER 

SET CONTAINER SET PROTOCOL 

SET ROUTE SET ROUTE 


SET SERVICE 


Note that the SET ROUTE command affects both the permanent and dynamic 
routing databases. 


1.1.2 Modifying the Configuration Database 


Unlike the other databases, which have similar objects, the configuration 
database holds diverse initialization information for various TCP/IP Services 
components. 


The following commands modify the configuration database: 


SET CONFIGURATION BIND 

SET CONFIGURATION COMMUNICATION 
SET CONFIGURATION ENABLE SERVICE 
SET CONFIGURATION INTERFACE 

SET CONFIGURATION NAME_SERVICE 
SET CONFIGURATION PROTOCOL 

SET CONFIGURATION SMTP 

SET CONFIGURATION SNMP 

SET CONFIGURATION START ROUTING 
SET CONFIGURATION TIME 


1.1.3 Creating and Deleting Files 
The CREATE commands create the following kinds of files: 


Database files 


HP strongly recommends that you use the TCP/IP Services configuration 
procedure (TCPIP$CONFIG) instead of manually creating databases. Refer to 
the HP TCP/IP Services for OpenVMS Installation and Configuration guide 
for instructions. 


Use the following commands to create database files: 
— CREATE BOOTP 

— CREATE CONFIGURATION 

— CREATE EXPORT 

— CREATE HOST 
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—- CREATE NETWORK 
— CREATE PROXY 
— CREATE ROUTE 

e UNIX container directories 


These directories are used by the NFS server software. Use the following 
commands to create and delete container directories and files: 


—- CREATE CONTAINER 
- DELETE CONTAINER 
-— CREATE DIRECTORY 
- REMOVE DIRECTORY 
—- REMOVE FILE 


1.1.4 Adding and Deleting Records 


To add and delete records from the TCP/IP Services databases, use the 
CONVERT, ADD, and REMOVE management commands. 


Use the following commands to add records to and delete records from the proxy 
and export databases: 


e ADD EXPORT 

e REMOVE EXPORT 
e ADD PROXY 

e REMOVE PROXY 


You cannot modify information that you enter into databases. Instead, delete the 
record with the REMOVE command and then issue a new ADD command. 


TCP/IP Services provides the following kinds of CONVERT management 
commands: 


e CONVERT/CONFIGURATION BIND 

Converts BIND configuration information to BIND Version 8.1 format. 
e CONVERT/VMS 

Populates an existing database with entries from a UNIX database file. 
e CONVERT/UNIX 


Reads a TCP/IP Services database and converts the information to a UNIX- 
formatted (sequential) database file. For example, CONVERT/UNIX HOST 
reads the hosts database and converts the records into a UNIX-formatted 
/etc/hosts file. 


1.1.5 Starting and Stopping Software 


You can start and stop software components interactively by using the following 
commands: 


e START MAIL 
e START ROUTING 
e STOP ROUTING 
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For example: 


TCPIP> START ROUTING /SUPPLY 


For the server components that are started by the auxiliary server upon an 
incoming client request, the ENABLE SERVICE command tells the the auxiliary 
server to listen for requests and act upon them. 


The DISABLE SERVICE command tells the auxiliary server to stop listening for 
incoming requests. 


Use the following commands to set components to start when TCP/IP Services 
starts. The permanent configuration is stored in the configuration database. 


SET CONFIGURATION ENABLE SERVICE 
SET CONFIGURATION ENABLE NOSERVICE 
SET CONFIGURATION START ROUTING 
SET CONFIGURATION START NOROUTING 


1.1.6 Validating Data Integrity 
Use the following commands to verify the integrity of TCP/IP Services files: 


ANALYZE CONTAINER 
ANALYZE MAIL 
ANALYZE SERVICE 


1.1.7 Managing NFS 


The NFS server requires the following management commands: 


MAP 

SET CONFIGURATION MAP 
SHOW MAP 
SHOW CONFIGURATION MAP 
UNMAP 
SET CONFIGURATION NOMAP 
SET NFS_SERVER 

SHOW NFS_SERVER 

CREATE EXPORT 

ADD EXPORT 

REMOVE EXPORT 

SET EXPORT 

SHOW EXPORT 

CREATE PROXY 
CONVERT/VMS PROXY 

ADD PROXY 

REMOVE PROXY 
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SHOW PROXY 


1.1.8 Using NFS 


The TCP/IP Services software includes commands for using NFS. Use the 
following commands to view container file systems and to copy files to and from 
them: 


CREATE DIRECTORY 
DIRECTORY 
REMOVE DIRECTORY 
REMOVE FILE 
CREATE CONTAINER 
DELETE CONTAINER 
EXPORT 

IMPORT 


For using the NFS client (working with files that reside on remote hosts), TCP/IP 
Services software provides the following commands: 


MOUNT 
SHOW MOUNT 
DISMOUNT 


1.1.9 Displaying Information 


The SHOW and LIST commands display configuration, status, and performance 
information. 


1.2 UNIX Management Commands 


You can use UNIX management commands to manage the TCP/IP Services 
software. Section 1.2.1 lists the supported UNIX management commands, and 
Section 1.2.2 gives a few tips about using UNIX management commands and 
provides sources for more information. 


1.2.1 Supported UNIX Management Commands 
Table 1-3 describes the supported UNIX commands. 


Table 1-3 UNIX Management Commands 


Command Description 


arp 


Controls and displays ARP tables for the specified host. 


ifconfig Configures or displays network interface parameters, redefines an 


address for a particular interface, or sets options such as an alias list, 
broadcast address, or access filter. 


netstat Displays network statistics of sockets, data link counters, specified 


protocols or aliases, network interfaces, and a host’s routing table. 


(continued on next page) 
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Using TCP/IP Services Management Commands 
1.2 UNIX Management Commands 


Table 1-3 (Cont.) UNIX Management Commands 


Command Description 


nfsstat Displays statistical information about the network file system (NFS) 
and remote procedure call (RPC) interfaces in the kernel. It can also be 
used to reinitialize this information. 


ripquery Requests all routes known by a RIP gateway by sending a RIP request 
or a POLL command. 


route Allows you to manipulate the routing table manually. Normally, a 
system routing table management component, such as GATED or 
ROUTED, will tend to this task. 


sysconfig Manages and displays network attributes in the kernel subsystem 
configuration. 

sysconfigdb Manages and displays network attributes in the subsystem 
configuration table (TCPIP$ETC:SYSCONFIGTAB.DAT). 

traceroute Displays the route that packets take to a network host. 

whois Displays user, host, and organization names in the Network 


Information Center (NIC) database. 


1.2.2 Using UNIX Management Commands 


To use UNIX management commands at the DCL prompt, execute the command 
procedure SYS$MANAGER:TCPIP$DEFINE_COMMANDS.COM. For example: 


$ @SYSSMANAGER:TCPIPSDEFINE COMMANDS .COM 


This command procedure defines process-specific commands that enable you to 
enter UNIX commands from the DCL prompt. Note that execution of a UNIX 
command in a DCL command procedure does not return an error in $STATUS, so 
you cannot test for the failure of a UNIX comand in a DCL command procedure. 


The following command shows how to obtain information about an interface 
configured on your host. Note the use of quotation marks to preserve the case 
of the command option. You must enclose uppercase options in quotation marks 
when entering UNIX commands. 


$ ifconfig "WFO" 
The following is displayed: 


WFO: flags=c43<UP,BROADCAST, RUNNING, MULTICAST, SIMPLEX> 
rxmt 1000, reach time 30000, dad tries 1, MT 4352, hops 64, token len 64 
inet 16.20.208.100 netmask ffff0000 broadcast 16.20.255.255 ipmtu 4470 
inet6 fe80::200:f8ff:fe66:2e35 


For more information about UNIX command options and flags, refer to the 
HP TCP/IP Services for OpenVMS Tuning and Troubleshooting manual, or 
enter HELP unix_command at the TCPIP> prompt. For example, to display 
information about the netstat command, enter: 


TCPIP> HELP NETSTAT 
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Command Descriptions 


This chapter describes the TCP/IP Services management commands in 
alphabetical order. 


For information about how to enter commands, see Chapter 1. 
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ADD EXPORT 


ADD EXPORT 


Format 


Adds an export entry, in the form of a UNIX path name, to the export database 
for a Network File System (NFS) file system. The path name is a name that is 
mapped to one of the following: 


e An OpenVMS disk 
e A subdirectory on an OpenVMS disk 
e A UNIX container file system 


Related commands: MAP, REMOVE EXPORT, SET CONFIGURATION MAP, 
SHOW EXPORT, SHOW HOST 


Applies to: NFS server 


ADD EXPORT "/path/name' 
/HOST=host 
[| /OPTIONS= 
[NO]DATA_CONVERSION 
[NOJNAME_CONVERSION 
[NO]JPURGE_VERSIONS 
[NO]JTYPELESS_DIRECTORIES ] 


Restrictions and Tips 


Parameters 


Qualifiers 


This command requires read and write access to the export database. The 
following restrictions and instructions apply: 


e Do not use wildcards within a UNIX directory specification. 
e For each host, define both its host name and any alias names. 
e For each entry, use uppercase and lowercase consistently. 


e If you remove an export entry and replace the entry using different options; 
each client must dismount and remount for the new options to take effect. 


"/path/name" 
Required. 


File system to add to the export database. 


Separate directory and subdirectory names with slashes. 


/HOST=host 
Required. 


The NFS client host or hosts that will have access to the specified NFS file 
system. 


You can use a wildcard to allow access to all hosts. 
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ADD EXPORT 


/OPTIONS= { [NO]DATA_CONVERSION |[NO]JNAME_CONVERSION 
|I[NO]JPURGE_VERSIONS I[NO]JTYPELESS DIRECTORIES } 
Optional. 


Note 


For clients operating in OpenVMS to OpenVMS mode, the server ignores 
the options in the export record and uses the settings required for 
OpenVMS to OpenVMS mode. 


Options for the specified directory: 
e DATA CONVERSION, NODATA_CONVERSION 


DATA CONVERSION (default) 

Converts the following kinds of sequential files: 
* Variable 

* Variable with fixed-length control (VFC) 

*  Fixed-record formats 


Converts sequential files according to the rules applied by the following 
record attributes: 


* Carriage return/carriage control (CR) 
* Fortran carriage control (FTN) 

* Print file-format control (PRN) 
Stream formats are returned unconverted. 


The data in files with nonstream records cannot be written back to the 
file. 


NODATA_CONVERSION 


File data is considered raw and is returned without conversion. 
Nonstream records are returned with their record control information 
mixed with the record data. Files can be rewritten randomly. 


e NAME_CONVERSION, NONAME_CONVERSION 


NAME_CONVERSION 


A non-OpenVMS client can create files with mixed-case names and names 
containing characters that are invalid for OpenVMS file names. The 
server converts such names to valid OpenVMS file names, and reverses 
the conversion when displaying the file names to a non-OpenVMS client. 


NONAME_CONVERSION (default) 


Clients can only create files with valid OpenVMS names. The server 
performs case-insensitive lookups and displays directories in lowercase. 


e PURGE_VERSIONS, NOPURGE_VERSIONS 
Default: NOPURGE_VERSIONS 


Deletes multiple versions of files. (The NFS CREATE and RENAME calls 
can create multiple versions. The NFS READDIR call can sense multiple 
versions.) 
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e TYPELESS_DIRECTORIES, NOTYPELESS_DIRECTORIES 
- TYPELESS_DIRECTORIES 


Removes .dir.1 from the name of directories. A naming conflict could 
arise if, for example, two files exist in the parent directory: 


DOVE.;1 (regular file) 
DOVE.DIR;1 (directory file) 


The name is returned as dove., rather than dove, if a file and a conflicting 
directory exist. 


- NOTYPELESS_DIRECTORIES (default) 


Returns names as file.ext and file.dir. 


Examples 


1. TCPIP> ADD EXPORT "/gold/finch" /HOST=GOLD 
Adds the name of UNIX directory /gold/finch to the export database and 
gives NFS client users on the remote host gold access to this directory. 

2. TCPIP> ADD EXPORT "/gold/finch" /HOST=(PURPLE, FINCH) 


Adds the directory /gold/finch to the export database and gives NFS client 
users on multiple remote hosts (PURPLE and FINCH) access to this directory. 
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ADD PROXY 


Adds entries to the proxy database that give remote users an OpenVMS identity 
(account name). Applies to the NFS server, NFS client, PC-NFS, RSH, LPR/LPD, 
and customer-developed services. 


The proxy database contains communication proxies and NFS proxies: 
e Communication proxy 


— Provides an identity for users of RSH, RLOGIN, REXEC, RMT/RCD, 
LPR/LPD, and customer-written services, if these services are marked 
with SET SERVICE /FLAGS=APPLICATION_PROXY. 


Note 


The ROOT account does not require a communication proxy in the proxy 
database. The /FLAGS=APPLICATION_PROXY flag, therefore, is not 
relevant when you are setting up a communication proxy for a UNIX root 
account. 


— Required qualifiers: /HOST, /REMOTE_USER. 
e NFS proxy 


— Provides an identity for users of NFS client, NFS server, PC-NFS. No two 
proxies can have the same UID and host combination. 


— Required qualifiers: /HOST, /GID, /UID. 
You can combine NFS and communication proxies in one record. 


Related commands: SHOW HOST, DCL command AUTHORIZE, 
CONVERT/VMS PROXY, REMOVE PROXY, SHOW PROXY 


Format for Communication Proxies 
ADD PROXY user { /HOST=host | /REMOTE_USER=user } 
[ PERMANENT ] 
Format for NFS Proxies 


ADD PROXY user { /GID=n | /HOST=host | /UID=n } 
[ /NFS=options ] 
[ PERMANENT ] 
Restrictions and Tips 


Requires read and write access to the proxy database and one of the following 


privileges: 
e SYSPRV 
e SYSLCK 
e OPER 


For each host, define both its host name and alias names. 
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ADD PROXY 


Parameters 


Qualifiers 


For each entry, use uppercase and lowercase consistently. 


user 
Required. 


Local OpenVMS identity for the user of: NFS server, NFS client, PC-NFS, remote 
shell, or LPR/LPD. 


/GID=n 
Required for an NFS proxy. 


Group identifier (GID) for an NFS user. 
Wildcards not allowed. 


/HOST=host 
Required. 


Host name on which the NFS user is working. 


e The host must be seen on the SHOW HOST/LOCAL display. It is important 
to use the SHOW HOST command to verify that the host is known to TCP/IP 
Services because ADD PROXY does not do this check. 


e A wildcard is allowed. 


e HP recommends that you define both the host name and any alias names. 


/NFS=[ INCOMING | OUTGOING ] 
Optional. Default: /NFS=INCOMING,OUTGOING). 


Creates an NFS proxy for local clients, remote clients, or PC-NFS clients. Specify 
one of the following: 


e /NFS=OUTGOING — Proxy to use NFS client 
e /NFS=INCOMING — Proxy to use NFS server 


e /NFS=(OUTGOING,INCOMING) — Proxy to use both NFS server and NFS 
client 


/PERMANENT 
Optional. Default: Both permanent and volatile databases. 


Adds the entry only to the permanent proxy database. 
e Communication proxy 


— If REMOTE_USER is not active, changes are made to the permanent 
database. 


— If REMOTE_user is active, changes to the permanent database take effect 
after you restart RSH, RLOGIN, or LPD. 


/REMOTE_USER=user 
Required for a communication proxy. Not valid on NFS proxy. 


Specifies the remote client’s user name. 


A wildcard is allowed. 
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ADD PROXY 


/UID=n 
Required for an NFS proxy. 


Specifies the user identifier (UID) for an NFS user. 


Wildcards are not allowed. 


1. TCPIP> ADD PROXY HAWAIIAN GOOSE /NFS=(OUTGOING, INCOMING) - 
_TCPIP> /GID=10 /UID=444 /HOST="nene" 


Creates a proxy called HAWAIIAN_GOOSE, authorizing use of both the NFS 
client and the NFS server to and from host nene. 


2. TCPIP> ADD PROXY COUSINS /GID=10 /UID=40 /NFS=OUTGOING - 
_TCPIP> /HOST=("grackle", "blackbird" ) 


Enters an NFS proxy called COUSINS for a local NFS client user named 
COUSINS. This user can access remote files from NFS servers grackle and 
blackbird. 


3. TCPIP> ADD PROXY REMOTE UGLY DUCKLING - 
_TCPIP> /REMOTE USER="cygnet" /HOST="babyswan" 


Adds to the proxy database communication proxy 
REMOTE_UGLY_DUCKLING for remote user cygnet at host babyswan. 
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ANALYZE CONTAINER 


Verifies the integrity of a UNIX container file, including the following checks: 
e Superblock validation 

e Inode validation 

e Directory validation 

e Internal allocation validation 

e Directory hierarchy validation 


Reports, and optionally corrects, problems within the structure of the container 
directory. Applies to the NFS server. 


Related commands: DIRECTORY, MAP, UNMAP 


Format 


ANALYZE CONTAINER — device:path.name 
[ NO|CONFIRM |] 
[ INOJREPAIR |] 


Restrictions and Tips 


e Before you enter the ANALYZE CONTAINER command, you must map the 
OpenVMS volume on which the container directory resides, using the MAP 
command. 


e Before you enter the ANALYZE CONTAINER command, unmap the container 
file system to prevent users from attempting to access to it while you analyze 
it. 


e This command requires the BYPASS privilege. 


Parameters 


device:path.name 
Required. 


Device and container directory to analyze. 


Qualifiers 


/CONFIRM 
/NOCONFIRM 
Optional. Default: /NOCONFIRM. 


Use only with the /REPAIR qualifier. 


When the software encounters a problem with the services database, it displays 
a description and solution and then requests confirmation before making each 
correction. For example: 
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$TCPIP-E-ANA SUP_BADIICGSIZE, Problem: Bad initial inode cell group 


size:bad value 


Solution: Will be replaced by default size: good_value 
CONFIRM [Y/N/G]: 


Examples 


Respond to the CONFIRM: prompt by entering one of the following: 
e Y to repair the problem 

e N to ignore the problem 

e Gto change to NO CONFIRMATION mode 


/REPAIR 
/NOREPAIR 
Optional. Default: /NOREPAIR. 


Any errors will be repaired. 


1. TCPIP> UNMAP "/wren20" 
TCPIP> ANALYZE CONTAINER DUAO: [WREN20 ] 


Verifies the integrity of container DUAO:[WREN20]. 
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ANALYZE MAIL 


Verifies the consistency of the SMTP queues with SMTP control files. 
Related commands: REMOVE MAIL, SHOW MAIL 


Format 


ANALYZE MAIL [ user ] 
[ [NO|CONFIRM ] 
[ /DELETE[=options | 
[ /HOLD=time ] 
[ /LOG=file } 
[ [NO]JREPAIR ] 
Restrictions 


Requires SYSNAM, SYSPRV, or BYPASS privilege to access mail that is not 
yours. 
Parameters 


user 
Optional. Default: All users. 


User whose mail you want to analyze. 


Qualifiers 


/CONFIRM 
/NOCONFIRM 
Optional. Default: /NOCONFIRM 


Use only with either the /REPAIR or the /DELETE qualifier. 


When the software encounters a problem, it displays a description and solution. 
If you specify the (CONFIRM qualifier, the software then requests confirmation 
before making a correction or deleting each record. Enter one of the following: 


e Y to repair the problem 
e N to ignore the problem 
e Gto change to NO CONFIRMATION mode 


/DELETE [=BEFORE=time | =SINCE=time] 
Optional. Default: Files not deleted. 


Deletes each control file without a corresponding queue entry. 
e =BEFORE=time 
— Deletes files created before the specified time. 


— Default: Current date and time. 
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Examples 


ANALYZE MAIL 


e =SINCE=time 
— Deletes files created since the specified time. 
— Default: Deletes all files. 


Use the /DELETE and /REPAIR qualifiers on the same command line only if their 
time frames do not conflict. 


The following command requeues lost mail created since yesterday and deletes all 
previous mail: 


TCPIP> ANALYZE MAIL /REPAIR /DELETE=BEFORE=YESTERDAY 


/HOLD=time 
Optional. Default: Immediate retransmission. 


Hold, until the specified time, lost control files that you requeued. 
/LOG[=file] 

Optional. Default: [current_default_dir]:TCPIP$SMTP_ANALYZE.LOG. 
Writes the ANALYZE MAIL log to the specified file. 


/REPAIR 
/NOREPAIR [=BEFORE=time | =SINCE=time] 
Optional. Default: /NOREPAIR. 


Corrects errors as follows: 


e Resubmits for delivery each valid control file in the SMTP directory with no 
entry in an SMTP queue. 


e Deletes each invalid control file (fails the internal consistency check) and the 
corresponding queue entry. 


e Either requeues or deletes messages placed on hold. 
Supports the following options: 
e =BEFORE=time 
— Deletes files created before the specified time. 
— Default: Current date and time. 
e =SINCE=time 
— Deletes files created since the specified time. 
— Default: Deletes all files. 
Do not use /REPAIR with /DELETE if their time frames conflict. 


1. TCPIP> ANALYZE MAIL /REPAIR 


Displays status for the SMTP queues, and requeues each valid control file 
that lacks a corresponding queue entry. 
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2. TCPIP> ANALYZE MAIL /DELETE 


Creates the summary of SMTP queues, and deletes each valid control file that 
lacks a corresponding SMTP queue entry. 


3. TCPIP> ANALYZE MAIL DRAKE /REPAIR /DELETE=BEFORE=24-APR-2003 
This command does the following: 
e Creates a summary of SMTP entries and control files for user DRAKE. 
e Requeues control files that lack corresponding queue entries. 


e Deletes control files created before April 24, 2003. 
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ANALYZE SERVICE 


Searches through the services database for corrupted definitions. Displays invalid 
records and, with the /REPAIR qualifier, deletes them. 


Related commands: SET SERVICE, SHOW SERVICE 


Format 


ANALYZE SERVICE [ /[NO|CONFIRM ] 
[ INOJREPAIR | 


Restrictions 


Requires write access to the directory with the services database. 


Qualifiers 


/CONFIRM 
/NOCONFIRM 
Optional. Default: /NOCONFIRM. 


Use only with the /REPAIR qualifier. 


When the software encounters a problem, it displays a description and a solution. 
If you specify the (CONFIRM qualifier, the software then requests confirmation 
before making a correction. 


Respond to the CONFIRM: prompt by entering one of the following: 
e Y to repair the problem 

e N to ignore the problem 

/REPAIR 


/NOREPAIR 
Optional. Default: /NOREPAIR 


Deletes the corrupted records. 


Examples 


1. TCPIP> ANALYZE SERVICE 


Invalid IP option records 
Service Port Proto Process Address 


TOE 25 TCP TOED 0.0.0.0 
NESTING 560 TCP NEW_EGGS TCPIP (0.0.0.0 


IP option records 
Total: 0 
Invalid: 0 


TCP option records 
Total: 7 
Invalid: 2 


Displays total and invalid protocol option records found in two service 
definitions, TOE and NESTING. 
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2. TCPIP> ANALYZE SERVICE /REPAIR /CONFIRM 


Invalid IP option records 


Service Port Proto Process Address 

TOE 67 UDP TOED 0.0.0.0 
Remove? [N]: YES 

Service Port Proto Process Address 

NESTING 69 UDP NEW_EGGS_TCPIP 0.0.0.0 


Remove? [N]: YES 


Displays the total protocol option records and deletes, after confirmation, the 
invalid records. 
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CONVERT/CONFIGURATION_BIND 


Format 


Parameters 


Qualifiers 


Examples 


Converts the UCX BIND Version 4.x name server configuration to the BIND 
Version 8.1 format. Applies to the BIND name server. Use this command if 
you have a BIND configuration from an earlier release (Version 4.2 or lower) of 
the TCP/IP Services software. This command extracts the BIND configuration 
information from the file UCK$CONFIGURATION.DAT and creates the ASCII 
file TCPIP$BIND.CONF. 


Related commands: SET CONFIGURATION BIND, SHOW CONFIGURATION 
BIND 


CONVERT/CONFIGURATION BIND  [bind_conf_file] 
[/CLUSTER=/broker_cont_file] 


bind_conf_file 
Optional. Default: SYS$SPECIFIC:[TCPIP$BIND]TCPIP$BIND.CONF. 


Specifies the alternate name or location of the BIND configuration file to be 
created. 


/CLUSTER=/broker_conf_file 
Optional. Default: SYS$SYSDEVICE:[TCPIP$LD_ 
BKR]TCPIP$LBROKER.CONF 


Creates the file used by the load broker for cluster load balancing. Here, 
lbroker_conf_file specifies the name of the load broker configuration file. 


1. TCPIP> CONVERT /CONFIGURATION BIND - 
_TCPIP> /CLUSTER=SYS$SYSDEVICE: [TCPIP$LD_BKR]TCPIPSLBROKER. CONF 


Converts the UCX BIND server configuration to BIND 

Version 8.1 format and creates the configuration file 
SYS$SPECIFIC:[TCPIP$BIND]TCPIP$BIND.CONF. The /CLUSTER qualifier 
creates the configuration file TCPIP${LBROKER.CONF used by the load 
broker. 


2. TCPIP> CONVERT /CONFIGURATION BIND SITE2_BIND.CONF 


Converts the UCX BIND server configuration and creates the configuration 
file SITE2_BIND.CONF. 


Refer to the HP TCP/IP Services for OpenVMS Management manual for more 
information about the BIND name server, resolver, and load broker. 
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CONVERT/UNIX BIND 


Creates a BIND server database and populates it with records from the local 
host and MX databases. This command will create either a forward translation 
file or a reverse translation file. If you specify a domain.name that ends in 
IN-ADDR. arpa, a reverse translation file is created. 


Related commands: SET HOST, SET MX_RECORD 


Format 
CONVERT/UNIX BIND /DOMAIN=domain.name 
[ [NOJLOG ] 
Qualifiers 


/DOMAIN=domain.name 
Required. 


Domain for which to extract data. Determines whether to perform forward 
translation or reverse translation. The following restrictions and instructions 


apply: 

e The domain name must be fully qualified. 
e The closing dot is not required. 

e Do not use wildcards. 


e Specify up to four parts of the IP address for varying degrees of selectivity. 
For example: 


/DOMAIN=16.IN-ADDR.arpa is less selective. 
/DOMAIN=8.20.16.IN-ADDR.arpa is more selective. 


The end of domain.name determines whether a forward or reverse translation is 
performed. For example: 


e If the domain name ends in IN-ADDR.arpa: 
— Reverse translation is performed. 


— The domain is some part of an IP address, reversed, and added to 
IN-ADDR. arpa. 


— The selection includes the contents of the hosts database in the output. 


e If the domain name ends in anything else (for example, 
/DOMAIN=DAW. MAG. COM): 


— Forward translation is performed. 


— All hosts in domain.name or in any of its subdomains are selected for the 
output file. 


— CONVERT/UNIX BIND does a forward translation and selects hosts in 
DAW.MAG.COM and in its subdomains. 


/LOG 
/NOLOG 
Optional. Default: /NOLOG. 
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Shows records as they are processed. 


Examples 


1. TCPIP> CONVERT/UNIX BIND /DOMAIN=KESTREL.SMALL. FALCON 


On host KESTREL, creates a BIND server database with default file name 
SYS$SPECIFIC:[TCPIP$BIND]KESTREL_SMALL_FALCON.DB. 


BIND and MX records for the host’s domain, kestrel.small. falcon, are 
extracted, converted, and written to KESTREL_SMALL_FALCON.DB. 
2. TCPIP> CONVERT/UNIX BIND /LOG /DOMAIN=ABC.COM 


Creates a BIND server database. The /LOG qualifier indicates that records 
will be displayed as they are processed. 
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CONVERT/UNIX HOST 


Reads the hosts database and converts the information to an ASCII file formatted 
for use as a hosts file on a UNIX system. 


The name and location of the hosts database is specified by the logical 
name TCPIP$HOST. If this name is not defined, the command looks for 
TCPIP$HOST.DAT in your current directory. 


Related commands: CREATE HOST, SET HOST, SHOW HOST 


Format 
CONVERT/UNIX HOST [ destination_file | 
[| /BYADDRESS | 
[ /LOG | 
Restrictions 
Requires: 
e Read access to the hosts database. 
e Write access to [JETC.HOSTS. 


Parameters 


destination_file 
Optional. Default: []ETC.HOSTS (UNIX formatted) 


Allows you to specify the name for the new file. 


Qualifiers 


/BYADDRESS 
Optional. Default: Sorts by name. 


Sorts entries in the converted file by IP address. 


/LOG 
Optional. Default: No display. 


Interactively displays the processing. 


Examples 


1. TCPIP> CONVERT/UNIX HOST 


Converts the hosts database TCPIP$HOST to an ASCII file that is formatted 
for use as a hosts file on a UNIX system. The resulting file is named (default) 
ETC.HOSTS in the current directory and can be used on a UNIX system as 
the file /etc/hosts. 
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CONVERT/UNIX NETWORK 


Converts the networks database to an ASCII file formatted for use on a UNIX 
system. 


The name and location of the networks database is specified by the logical 
name TCPIP$NETWORK. If this name is not defined, the command looks for 
TCPIP$NETWORK.DAT in your current directory. 


Related commands: CREATE NETWORK, SET NETWORK, SHOW 
NETWORK 


Format 


CONVERT/UNIX NETWORK. [ destination_file | 
[ /BYADDRESS ] 
[ /LOG ] 


Restrictions 
Requires: 
e Read access to the hosts database. 


e Write access to the file []ETC.NETWORKS. 


Parameters 


destination_file 
Optional. Default: [JETC.NETWORKS (UNIX formatted). 


Specifies the name of the new UNIX formatted file. 


Qualifiers 


/BYADDRESS 
Optional. Default: Sorts by name. 


Sorts the converted file by network number. 


/LOG 
Optional. Default: No display. 


Displays messages generated during processing. 


Examples 


1. TCPIP> CONVERT/UNIX NETWORK /LOG 


Converts the networks database (TCPIP$NETWORK) to the ASCII file 
[JETC.NETWORKS. This resulting file can be used as a networks database 
file /etc/networks on a UNIX system. The /LOG qualifier displays each 
record as it is converted. 


2. TCPIP> CONVERT/UNIX NETWORK NETWORKS.TXT 


Converts the networks database (TCPIP$NETWORK) to the ASCII file 
[JINETWORKS.TXT. The resulting file may be used as the networks database 
file /etc/networks on a UNIX system. 
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CONVERT/VMS BOOTP 


Populates the existing BOOTP database with entries from a BIND-formatted 
UNIX /etc/bootptab file. 


If the logical name TCPIP$BOOTP is defined, it is used to specify the directory 
and file name for the database. If TCPIP$BOOTP is not defined, the database is 
created as [current_directory]TCPIP$BOOTP.DAT. 


Related commands: CREATE BOOTP, SET BOOTP, SHOW BOOTP 


Format 
CONVERT/VMS BOOTP  [ source_file ] 
[ /ADD_HOST ] 
[ /FILE=sys_image_tfile | 
Restrictions 
Requires: 
e Read and write access to the hosts database (if using /ADD_HOST qualifier). 


e Read access to the hosts database. 


Parameters 


source_file 
Optional. Default: []ETC.BOOTPTAB in your current directory. 


File to be converted. 


Qualifiers 


/ADD_HOST 
Optional. Default: No adding. 


Adds new host names found in the UNIX /etc/bootptab file to 
TCPIP$HOST.DAT. 


/FILE=sys_image_file 
Optional. Default: None. 


Specifies the name of the client’s system image file to download if this file name 
is not in the BOOTP database. 


Examples 


1. TCPIP> CONVERT/VMS BOOTP BOOTP.DAT /ADD_HOST 


Converts a UNIX ASCII boot data file to an OpenVMS indexed file. 
BOOTP.DAT specifies the source UNIX boot file to convert. For new hosts, 
the /ADD_HOST qualifier adds the host to the hosts database. 
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CONVERT/VMS HOST 


Populates the existing hosts database with entries from a UNIX /etc/hosts file. 


The name and location of the hosts database is specified by the logical 
name TCPIP$HOST. If this name is not defined, the command looks for 
TCPIP$HOST.DAT in your current directory. 


Related commands: CREATE HOST, SET HOST, SHOW HOST 


Format 
CONVERT/VMS HOST [ source_file ] 
[ /LOG ] 
[ /UPCASE } 
Restrictions 
Requires: 
e Read and write access to the hosts database. 
e Read access to the UNIX formatted hosts file. 


e Exclusive use of the hosts database. 


Parameters 


source_file 
Optional. Default: ETC.HOSTS in your current directory. 


UNIX formatted file to be converted to the TCPIP$HOST database file. 


Qualifiers 


/LOG 
Optional. Default: No logging. 


Displays records as they are being processed. 


/UPCASE 
Optional. Default: Not created. 


Creates an uppercase alias name for each host. 


Examples 


1. TCPIP> CONVERT/VMS HOST 


Converts the UNIX formatted hosts database file to the file 
TCPIP$HOST.DAT. The name of the UNIX formatted file is ETC.HOSTS 
in your current directory. 


2. TCPIP> CONVERT/VMS HOST HOSTS.TXT 


Converts the UNIX formatted hosts database file HOSTS.TXT to the file 
TCPIP$HOST.DAT. 
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CONVERT/VMS NETWORK 


Populates the existing networks database with entries from a UNIX 
/etc/networks file. 


The name and location of the networks database is specified by the logical 
name TCPIP$NETWORK. If this name is not defined, the command looks for 
TCPIP$NETWORK.DAT in your current directory. 


Related commands: CREATE NETWORK, SET NETWORK, SHOW 
NETWORK 


Format 
CONVERT/VMS NETWORK [ source_file | 
[ /LOG ] 
[ /UPCASE ] 
Restrictions 
Requires: 
e Read and write access to the networks database. 
e Read access to []ETC.NETWORKS. 


e Exclusive use of the networks database. 


Parameters 


source_file 
Optional. Default: ETC.NETWORKS in your current directory. 


Name of the file to be converted. 


Qualifiers 


/LOG 
Optional. Default: Log file created. 


Interactively displays records as they are being processed. 


/UPCASE 
Optional. Default: Alias not created. 


Specifies that an uppercase alias name be created for each network name. 


Examples 


1. TCPIP> CONVERT/VMS NETWORK 


Converts a UNIX formatted /etc/networks database file into a TCP/IP 
Services formatted networks database. The OpenVMS file name of 
/etc/networks is ETC.NETWORKS in your current directory. 


2. TCPIP> CONVERT/VMS NETWORK /UPCASE 


Converts a UNIX formatted database file to a TCP/IP Services formatted 
networks database. An uppercase alias name is created for each network 
name. 
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CONVERT/VMS PROXY 


Populates the existing proxy database with entries from a UNIX /etc/passwd file. 


The name of the proxy database is specified by the logical name TCPIP$PROXY. 
If this name is not defined, the command looks for TCPIP$PROXY.DAT in your 
current directory. 


Related commands: ADD PROXY, CREATE PROXY 
Applies to: NFS server, NFS client, PC-NFS 


Format 
CONVERT/VMS PROXY [ source_file | 
[ /LOG ] 
Restrictions 
Requires: 
e Read and write access to the proxy database. 
e Read access to []JETC.PASSWORD. 


e Exclusive use of the proxy database. 


Parameters 


source_file 
Optional. Default: ETC.PASSWD in your current directory. 


ASCII file to convert to a TCP/IP Services proxy database. 


Qualifiers 

/LOG 

Optional. Default: No display. 

Displays records as they are being processed. 
Examples 


1. TCPIP> CONVERT/VMS PROXY 


Converts a UNIX formatted /etc/passwd file to an OpenVMS formatted proxy 
database. The OpenVMS file name of /etc/passwd is ETC.PASSWD in your 
current directory. 


2. TCPIP> CONVERT/VMS PROXY UNIX PASSWDS.TXT 


Converts a UNIX formatted /etc/passwd file to an OpenVMS formatted 
proxy database. In this example, the file UNIX_PASSWDS.TXT contains the 
/etc/passwd data. 
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CREATE BOOTP 


Creates the BOOTP database file, using the file name and location specified by 
the logical name TCPIP$BOOTP. If the logical name is not defined, creates the 
database file in your current directory as TCPIP$BOOTP.DAT. 


Related commands: CONVERT/VMS BOOTP, SET BOOTP 


Format 
CREATE BOOTP 
Restrictions 
Requires write access to the directory with the BOOTP configuration database. 
Caution 
Do not execute this command unless you intend to reconfigure your entire 
cluster. 
Examples 


1. TCPIP> CREATE BOOTP 
Creates an empty BOOTP database. 
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CREATE CONFIGURATION 


Creates the configuration database file, using the file name and location 
specified by the logical name TCPIP$CONFIGURATION. If the logical 
name is not defined, creates the database file in your current directory as 
TCPIP$CONFIGURATION.DAT. 

Format 


CREATE CONFIGURATION 


Restrictions 


Requires write access to the directory with the configuration database. 


Caution 


Do not execute this command unless you intend to reconfigure your entire 
cluster. 


Examples 


1. TCPIP> CREATE CONFIGURATION 


Creates an empty configuration database. 
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CREATE CONTAINER 


Creates a UNIX file system with: 

e An empty OpenVMS style root directory 

e An empty local directory that corresponds to the UNIX root directory 
e A container file in the OpenVMS style root directory 

Applies to: NFS server 


Format 


CREATE CONTAINER § device:directory 
[ /HOST=host ] 
[ [NOJLOG ] 
[ /OWNER=[uic] ] 
[ /ROOT_MODE=n J 
[ /SIZE=option=value | 
[ /UID=n | 
[ /USER_NAME=vms_user_name ] 


Restrictions 
Requires: 


e Read and write access to the specified device and directory. 
e SYSPRV or BYPASS privilege. 


Parameters 


device: directory 
CONTAINER command) 
Required. 


Device and directory of the UNIX container. 


Qualifiers 


/HOST=host 
Required. Default: None. 


If the proxy database has multiple entries with the same user name and UID, the 
NFS server selects the entry specified with this qualifier. 


/LOG 
/NOLOG 
Optional. Default: Displays host, UID, GID, and user name. 


Displays a full description of the specified proxy database record for you to 
determine ownership (see /USER_NAME). 


/OWNERZ=[uic] 
Optional. Default: UIC in the selected proxy record. 


OpenVMS ownership of the container file directory and container file. 
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(The other files in this directory are owned by the OpenVMS users whose proxy 
database entries correspond to the UNIX owner UIDs of the individual files.) 


/ROOT_MODE=n 
Optional. Default: 755 (provides the following protection for owner, group, and 
world rwx-rx-rx). 


UNIX protection of the default container files: root directory, bit map, and 
superblock. 


Specify octal values in the following order: for user, for group, for others. The 
values are: 


¢ 0—Nbo access 

e 1 — Execute access 

e 2— Write access 

e 3— Write and execute access 

e 4— Read access 

e 5 — Read and execute access 

e 6— Read and write access 

e 7— Read, write, and execute access 
For example, /ROOT_MODE=751 provides: 


User Read, write, and execute access ii rwx 
Group Read and execute access 5 rx 
Other Execute access 1 x 


/SIZE=option=value 
Optional. Default: /SIZE=(INITIAL=8917,EXTEND=160,MAXIMUMZ=0). 


Specifies the following file size attributes: 
e INITIAL 


Specifies the initial size, in OpenVMS blocks, of the container. Maximum 
value: 8917. 


e EXTEND 


When an extension is necessary, specifies the number of blocks by which the 
container is extended. Maximum value: 8192. 


Note 


Using large values might impact system performance and disk usage. In 
most cases, the default is sufficient. 


e MAXIMUM 
Specifies the maximum size of the container. 


If the value is zero, the size of the container file can increase without limits. 


/UID=n 
Optional. Default: UID in the selected proxy record. 
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Specifies the owner of the UNIX container root directory. 


/USER_NAME=vms_user_name 
Required. 


Specifies the user name of the owner of the container file system. The user name 
must be in the proxy database. The specified user becomes the owner of the 
internal root directory of the container. 


Examples 


1. TCPIP> CREATE CONTAINER DUCK$4:[DUCKLING] /HOST=MALLARD - 
_TCPIP> /OWNER=[300,12] /ROOT_MODE=755 /UID=7015 - 
“TCPIP> /USER_NAME=G_JONES 


Creates container directory DUCK$4:[DUCKLING]. The local OpenVMS 
owner is [300,12]. Remote users see the root directory as owned by UID 7015. 
The root directory is writable only by UID 7015; it is readable and executable 
by all others. Before you execute this command, user G_JONES should have 
both an OpenVMS account with UIC [300,12] and an incoming proxy record 
specifying UID 7015 on host MALLARD. 
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CREATE DIRECTORY 


CREATE DIRECTORY 


Format 


Restrictions 


Parameters 


Qualifiers 


Creates a directory within an existing UNIX container. 
Applies to: NFS server 
Related commands: DIRECTORY, REMOVE DIRECTORY 


CREATE DIRECTORY "/path/name' 
[ /HOST=host ] 
[ /[NOJLOG ] 
[ /MODE=n | 
[ /UID=n ] 
[| /USER_NAME=vms_user_name ] 


Requires: 
e Read and write access to the parent directory. 


e SYSPRV or BYPASS privilege if you specify /USER_NAME with a name other 
than your own. 


The container file system must be mapped with the MAP command. 


"/path/name" 
Required. 


Name of the directory you want to create. 


/HOST=host 
Optional. Default: Uses the first user name found. 


If the proxy database has multiple entries with the same user name and UID 
combination, the value of /HOST determines the specified record. 


/LOG 
/NOLOG 
Optional. Default: Displays values for host, UID, GID, and user name. 


Displays a full description of the specified proxy database record for you to 
determine ownership (see /USER_NAME). 


/MODE=n 
Optional. Default: 755 (provides the following protection for owner, group, and 
world: rwx-rx-rx). 


UNIX protection of the new directory. 


Specify octal values in the following order: for user, for group, for others. The 
values are: 


¢ 0—No access 
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CREATE DIRECTORY 


Examples 


e 1— Execute access 

e 2— Write access 

e 3— Write and execute access 

e 4— Read access 

e 5 — Read and execute access 

¢ 6— Read and write access 

e 7— Read, write, and execute access 


For example, /MODE=751 provides: 


User Read, write, and execute access i rwx 
Group Read and execute access 5 rx 
Other Execute access 1 x 
/UID=n 


Optional. Default: None. 


Entry in the proxy database that determines, if necessary, the ownership of the 
container root directory. 


In the proxy database: 
e UID and GID fields determine the root directory’s UNIX identity. 
e User name field determines the OpenVMS ownership. 


Required to access an entry in the proxy database that lacks a unique UID, user 
name, and host combination. 


You can use /UID with the /HOST and /USER_NAME qualifiers. If you do not 
have SYSPRV or BYPASS privilege, the values you specify must correspond to 
the values for your user name in the proxy database. 


/USER_NAME=vms_user_name 
Optional. Default: UID=0 and GID=1 (if you have SYSPRV or BYPASS privilege). 


Selects an entry in the proxy database and creates the UID, GID, and OpenVMS 
UIC for the directory files. 


To select a user name that has a UIC different than the UIC of the process 
running the management program, you need SYSPRV or BYPASS privilege. 


You can use /USER_NAME in combination with /HOST and /UID. However, 
if you do not have SYSPRV or BYPASS privilege, the values you specify must 
correspond to the values for your user name in the proxy database. 


1. TCPIP> MAP "/user" dua0:[group a] 
TCPIP> CREATE DIRECTORY "/user/umbrella.bird" 


Creates a UNIX directory for user UMBRELLA called umbrella.bird. 


In this example, the user UMBRELLA is running the TCP/IP Services 
management program from the directory ((UMBRELLA.BIRD]). The UIC for 
[UMBRELLA] is [340,6] and the TCPIP$PROXY entry is defined as follows: 
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User UID GID Host 
UMBRELLA 300 12 e 
SYSTEM 0 1 * 


If UMBRELLA does not have SYSPRV or BYPASS privilege, the directory is 
created as follows: 


UID = 300 

GID = 12 

UIC = [340,6] 
If UMBRELLA has SYSPRV or BYPASS privilege, the directory is created as 
follows: 

UID = 0 

GID = 1 

UIC = [SYSTEM] 
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CREATE EXPORT 


Creates the export database file, using the file name and location specified by 
the logical name TCPIP$EXPORT. If the logical name is not defined, creates the 
database file in your current directory as TCPIP$EXPORT.DAT. 


Related commands: ADD EXPORT, SHOW EXPORT 
Applies to: NFS server 


Format 
CREATE EXPORT 


Restrictions 


Requires write access to the directory with the export database. 


Caution 


Do not execute this command unless you intend to reconfigure your entire 
cluster. 


Examples 


1. TCPIP> CREATE EXPORT 


Creates an empty export database. 
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CREATE HOST 


Format 


Restrictions 


Examples 


Creates a hosts database file with: 

e One entry for LOCALHOST 

e LOCALHOST’s alias, localhost 

e LOCALHOST’s address, 127.0.0.1 


The hosts database file name and location are specified by the logical name 
TCPIP$HOST. If the logical name is not defined, the database file name will be 
TCPIP$HOST.DAT in your current directory. 


Related commands: SET HOST, SHOW HOST, CONVERT/VMS HOST 


CREATE HOST 


Requires: 
e Write access to the directory with the hosts database. 


e Read and write access to the hosts database. 


Caution 


Do not execute this command unless you intend to reconfigure your entire 
cluster. 


1. TCPIP> CREATE HOST 
Creates a hosts database with one entry for LOCALHOST. 
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CREATE NETWORK 


Creates the networks database file, using the file name and location specified by 
the logical name TCPIP$NETWORK. If the logical name is not defined, creates 
the database file in your current directory as TCPIPSNETWORK.DAT. 


Related commands: SET NETWORK, SHOW NETWORK, 
CONVERT/VMS NETWORK 


Format 
CREATE NETWORK 
Restrictions 
Requires write access to the directory with the networks database. 
Caution 
Do not execute this command unless you intend to reconfigure your entire 
cluster. 
Examples 


1. TCPIP> CREATE NETWORK 


Creates an empty networks database. 
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CREATE PROXY 


Creates the proxy database file, using the file name and location specified by 
the logical name TCPIP$PROXY. If the logical name is not defined, creates the 
database file in your current directory as TCPIP$PROXY.DAT. 


Related commands: ADD PROXY, SHOW PROXY, CONVERT/VMS PROXY 


Format 
CREATE PROXY 
Restrictions 
Requires write access to the directory with the proxy database. 
Caution 
Do not execute this command unless you intend to reconfigure your entire 
cluster. 
Examples 


1. TCPIP> CREATE PROXY 


Creates an empty proxy database. 
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CREATE ROUTE 


Creates the routes database file, using the file name and location specified by the 
logical name TCPIP$ROUTE. If the logical is not defined, creates the database 
file named TCPIP$ROUTE.DAT in your current directory. 


Related commands: SET ROUTE, SHOW ROUTE 


Format 
CREATE ROUTE 
Restrictions 
Requires write access to the directory with the routes database. 
Caution 
Do not execute this command unless you intend to reconfigure your entire 
cluster. 
Examples 


1. TCPIP> CREATE ROUTE 


Creates an empty routes database. 
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DEFINE COMMUNICATION CONTROLLER 


Format 


Parameters 


Defines the mapping between a communication controller device and its 
corresponding Internet interface. Each mapping or controller definition is stored 
as a record in the configuration database. 


To modify an existing controller definition, you must delete the old 
controller definition from the configuration database (using the DELETE 
COMMUNICATION_CONTROLLER command) and then define the new 
controller definition (using the DEFINE COMMUNICATION_CONTROLLER 
command). 


Internet devices are uniquely identified using 2-character names. The first 
character is determined by the /INTERNET_INTERFACE qualifier. The second 
character is determined by the controller type you specify with the /TYPE 
qualifier, as follows: 


Controller Type Second Character of Interface Name 
ETHERNET E 
FDDI F 
PPP P 
SERIAL L 
TOKEN_RING T 


For example, with the following command, the communication controller EW 
maps to the interface WE: 


TCPIP> DEFINE COMMUNICATION CONTROLLER EW - 
_TCPIP> / INTERNET INTERFACE=W /TYPE=ETHERNET 


Related commands: LIST COMMUNICATION _CONTROLLER, 
DELETE COMMUNICATION_CONTROLLER, all INTERFACE commands 


DEFINE COMMUNICATION_CONTROLLER _ controller 
[ /DESCRIPTION=text ] 
/INTERNET_INTERFACE=character 
/TYPE=(optior].,...]) 


controller 
Required. 


Specifies the OpenVMS device name of the communication controller (as displayed 
by the DCL command SHOW DEVICE) to be mapped to an Internet interface. 
For examples of communication controllers with their corresponding Internet 
interfaces, refer to the LIST COMMUNICATION_CONTROLLER command. For 
more information on configuring network interfaces, refer to the HP TCP/IP 
Services for OpenVMS Management manual. 
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Qualifiers 


/DESCRIPTION=text 
Optional. Default: None. 


Optional text describing the communication controller. 
/AINTERNET_INTERFACE=character 
Required. 


Specifies the first character of the Internet interface name. If you prefer using a 
standard name, call your HP support representative. 


/TYPE=(option{,...]) 
Required. 


Specifies the communication controller type and cluster attribute. You must 
specify one of the following communication controller types: ETHERNET, FDDI, 
PPP, SERIAL, or TOKEN_RING. 


Optionally, specify the CLUSTER attribute to indicate that the interface can 
join an Internet cluster. To enable a cluster alias (alias host identifier) with an 
interface, use the SET INTERFACE /CLUSTER command. 


Examples 


1. TCPIP> DEFINE COMMUNICATION CONTROLLER ES - 
_TCPIP> / INTERNET _INTERFACE=S /TYPE=(ETHERNET,CLUSTER) - 
TCPIP> /DESCRIPTION="DESVA-Class Ethernet Adapter" 


Defines the OpenVMS device ES as the Internet interface SE, which can join 
an Internet cluster. 
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DELETE COMMUNICATION_CONTROLLER 


Format 


Restrictions 


Parameters 


Qualifiers 


Examples 


Deletes communication controller definitions from the configuration database. 


Related commands: DEFINE COMMUNICATION_CONTROLLER, 
LIST COMMUNICATION_CONTROLLER 


DELETE COMMUNICATION_CONTROLLER [ controller | 
[ [NO|CONFIRM J 
[ /INTERNET_INTERFACE=character | 


Requires OPER privilege. 


controller 
Required. 


Specifies the OpenVMS device name of the communication controller. 


/CONFIRM 
/NOCONFIRM 
Optional. Default: /CONFIRM if you use wildcards; otherwise, /NOCONFIRM. 


If you specify the /CONFIRM qualifier, a message displays asking you to confirm 
the delete request. Respond to the CONFIRM: prompt by entering one of the 
following: 


e Y to delete the entry 
e N to retain the entry 


If you specify the /NOCONFIRM qualifier, the operation is performed without 
asking you to confirm the request. 


ANTERNET_INTERFACE=character 
Optional. Default: All alphabetic characters. 


Specifies the first character of the Internet interface name of communication 
controller definitions to delete from the configuration database. 


1, TCPIP> DELETE COMMUNICATION CONTROLLER EZ 


Deletes from the configuration database the communication controller 
definition corresponding to the OpenVMS device EZ. 


2. TCPIP> DELETE COMMUNICATION CONTROLLER * - 
_TCPIP> /INTERNET_INTERFACE=W 


Deletes all the communication controller definitions having an Internet 
interface name that begins with the letter W. 
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DELETE CONTAINER 


Deletes a container file system and all its contents. 
Applies to: NFS server 
Related commands: CREATE CONTAINER 


Format 
DELETE CONTAINER  container_file_system 


Restrictions 
Wildcards are not allowed. 


Requires both read and delete access to the directory. 
Requires BYPASS privilege. 


Parameters 
container_file_system 
Required. 
Device and directory name of the container file (no wildcards). 
The container file has file type CONTAINER. 
Examples 


1. TCPIP> DELETE CONTAINER WORK1$:[DOVE.NEST BUILDING] 


Deletes the container directory WORK1$:[DOVE.NEST_BUILDING] along 
with the container file, all subdirectories, and files. 
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DIRECTORY 


Displays a list of files, along with typical directory information, in a UNIX 
container directory. 


Applies to: NFS server 


Format 
DIRECTORY  "/path/name' 
[ /FULL ] 
[ VMS ] 
Restrictions 
Requires: 
e Read access to the specified container directory. 


e BYPASS privilege. 


Parameters 


"/path/name" 
Required. 


Name of the UNIX container directory for which you want a directory listing and, 
optionally, directory names. 
Qualifiers 


/FULL 
Optional. Default: Brief display. 


Displays a comprehensive list of information, including the OpenVMS file name, 
for each file. 


VMS 
Optional. Default: No OpenVMS file names provided. 


Provides the corresponding OpenVMS file name for each file. 


Examples 
1. TCPIP> DIRECTORY/FULL "/nest_container" 


Directory: /nest_container 


OpenVMS file: _$1$DISK:[SYSTEM.NEST.HATCHLING]00012301$BFS.DIR;1 


Size File ID: 74497 

Blocks: 4 Owner 

Bytes: 1915 UID: 0 

Created: 1-NOV-2002 13:17:18.91 GID: 1 

Revised: 1-NOV-2002 13:17:19.24 Mode: 755 Type: Directory 
Accessed: 1-NOV-2002 13:16:20.52 Links: 2 
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OpenVMS file: _$1S$DISK:[SYSTEM.NEST.HATCHLING]00012301$BFS.DIR;1 


Size File ID: 74497 

Blocks: 4 Owner 

Bytes: 1915 UID: 0 

Created: 1-NOV-2002 13:17:18.91 GID: { 

Revised: 1-NOV-2002 13:17:19.24 Mode: 755 Type: Directory 
Accessed: 1-NOV-2002 13:16:20.52 Links: 2 

-SUPER.SYS 

OpenVMS file: no corresponding file 

Size File ID: 6145 

Blocks: 1 Owner 

Bytes: 54 UID: 0 

Created:  1-NOV-2002 13:17:18.91 GID: 1 

Revised: 1-NOV-2002 13:17:17.24 Mode: 644 Type: File 
Accessed: 1-NOV-2002 13:16:18.52 Links: 1 

.BITMAP.SYS 

OpenVMS file: no corresponding file 

Size File ID: 6657 

Blocks: 16 Owner 

Bytes: 8187 UID: 0 

Created:  1-NOV-2002 13:17:18.91 GID: 1 

Revised: 1-NOV-2002 13:17:17.24 Mode: 644 Type: File 
Accessed: 1-NOV-2002 13:16:18.52 Links: 1 


-HISTORY.SYS 
OpenVMS file: no corresponding file 


Size File ID: 66305 
Blocks: 1 Owner 
Bytes: 129 UID: 0 
Created: 1-NOV-2002 13:17:18.91 GID: 1 
Revised: 1-NOV-2002 13:17:17.24 Mode: 644 Type: File 
Accessed: 1-NOV-2002 13:16:18.52 Links: 1 


Displays a full directory listing of the container file system /nest_container. 


2. TCPIP> DIRECTORY "/dove/nest/plans" 


Displays names of the files in UNIX directory /dove/nest/plans. 
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DISABLE SERVICE 


Format 


Parameters 


Qualifiers 


For most services, this command disables the specified service but does not stop 
the current process. This allows you to perform an orderly shutdown of the 
service, which prevents new connections while allowing current connections to 
continue. 


To stop and restart the current process: 


1. Wait until the process exits, or stop it using the service-specific shutdown 
command procedure (TCPIP$service_ SHUTDOWN.COM). 


2. Restart the service using the service-specific startup command procedure 
(TCPIP$service_STARTUP.COM). 


Note that, for the NFS server, TELNET, and RLOGIN, the DISABLE SERVICE 
command stops the current process. 


Related commands: ENABLE SERVICE, SET SERVICE, SHOW SERVICE 


DISABLE SERVICE service 
[| /ADDRESS=!/P_address | 
[ /PORT=n | 
[ /PROCESS=process | 
[ /PROTOCOL=protocol ] 


service 
Required. 


Service you want to disable. Specify any service that appears in the SHOW 
SERVICE display. To disable all services, use a wildcard. 


/ADDRESS=!P_address 
Optional. Default: 0.0.0.0. 


Disables only the services for the specified address. 


/PORT=n 
Optional. Default: All ports. 


Disables the service communicating at the specified port. 


/PROCESS=process 
Optional. Default: All processes. 


Disables the service running as the specified process. 


/PROTOCOL=protocol 
Optional. Default: All protocols. 


Disables only the services that use the specified protocol. 


Command Descriptions 2-43 


DISABLE SERVICE 


Examples 


1. TCPIP> DISABLE SERVICE TELNET 
Disables TELNET. 


2. TCPIP> DISABLE SERVICE RLOGIN /ADDRESS=130.180.4.7 
Disables the remote login process that is bound to address 130.180.4.7. 


2-44 Command Descriptions 


DISCONNECT DEVICE_SOCKET 


DISCONNECT DEVICE SOCKET 


Interactively terminates a TCP/IP connection. 


Format 
DISCONNECT DEVICE_SOCKET dev_sock_number 
Parameters 
dev_sock_number 
Required. 
Number of the device socket associated with the connection you want to 
terminate. 
Examples 


1. TCPIP> DISCONNECT DEVICE SOCKET BG123 
Interactively terminates the connection at DEVICE_SOCKET BG123. 
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DISMOUNT 


Makes a physically remote file system that is currently accessible to local users 
inaccessible. 


Dismounts a remote file system or directory from local device DNFSn: (the mount 
point). 


Related commands: MOUNT, SHOW MOUNT 
Applies to: NFS client 


Format 


DISMOUNT { mount_point | logical_name } 
[ /ALL ] 
[ /HOST=host ] 
[ /[NO]WAIT ] 


Restrictions 


Dismounting a /SYSTEM mount requires SYSNAM privilege. 
Dismounting a /GROUP mount requires GRPNAM privilege. 


Parameters 


mount_point 
Required (if you omit logical_name and the /ALL qualifier). Default: None. 


DNFS device (and optional directory tree) required to dismount. Specify this 
mount point as one of the following: 


DNFSn: 
DNFSn:[dir.subdir] 
DNFSn:[dir.subdir]file 


where: 
n Value from 1 to 9999. 
[dir] or Directory to mount 


[dir.subdir] (up to eight in addition to the [000000] directory). 


file Individual file to dismount. 


If you use the /ALL qualifier, you must specify DNFSn: without the directory 
tree. 


logical_name 
Required (if you omit mount_point and the /ALL qualifier). Default: None. 


Logical name that you defined with the MOUNT command of the device to 
dismount. 
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Qualifiers 


Examples 


DISMOUNT 


/ALL 
Optional. 


Dismounts one of the following: 

e All file systems from all servers: DISMOUNT /ALL 

e All file systems on the specified server: DISMOUNT /ALL /HOST=host 
e All file systems on the specified device: DISMOUNT DNFSn: /ALL 


If you dismount using the /ALL qualifier, the dismount operation completes even 
if the server is not currently reachable. 


/HOST=host 
Optional. Default: None. 


Dismounts all file systems from the specified NFS server. 


Valid only with the /ALL qualifier. 


/WAIT 
/NOWAIT 
Optional. Default: /NOWAIT. 


e /WAIT 
— Does not dismount the mounted file system if outstanding activities exist. 
— Waits until the dismount has been completed. 
— Ifyou try to access any files on the mount point, the dismount fails. 
e /NOWAIT 
— The client completes the command immediately. 


— Dismounting does not actually occur until all file activity has been 
completed. 


1. TCPIP> DISMOUNT DNFS3: 


Makes the file system mounted on local device DNFS3: inaccessible to local 
users. 


2. TCPIP> DISMOUNT DNFS4:[USR.MNT] 


Dismounts only the specified mount point, [USR.MNTI, on local device 
DNFS4:. 


3. TCPIP> DISMOUNT DNFS5: /WAIT 
Dismounts the DNFS5:[000000] mount point and waits for it to occur. 


4. TCPIP> DISMOUNT /ALL 


Dismounts all mount points on all devices. 
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5. TCPIP> DISMOUNT /ALL /HOST="robin" 


Dismounts all mount points served by host robin. 
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ENABLE SERVICE 


Format 


Parameters 


Qualifiers 


Examples 


Enables a service on the running TCP/IP Services software. 
Related commands: DISABLE SERVICE, SHOW SERVICE 


ENABLE SERVICE [ service ] 
[| /ADDRESS=!/P_address | 
[ /PORT=n | 
[ /PROCESS=process | 
[| /PROTOCOL=protocol | 


service 
Optional. Default: All services. 


Specifies the service to enable. The service must be defined in the services 
database. 


/ADDRESS=!P_address 
Optional. Default: 0.0.0.0. 


Binds the service only to the specified address. If your host is multihomed, use 
this qualifier to configure the service to be offered on a specific Internet interface. 


/PORT=n 
Optional. Starts the service on the specified port. 


/PROCESS=process 
Optional. 


Runs the service as the specified process. 


/PROTOCOL=protocol 
Optional. Default: TCP. 


Runs the service with the specified protocol. 


1. TCPIP> ENABLE SERVICE TELNET 


Initializes TELNET communications. 


2. TCPIP> ENABLE SERVICE RLOGIN /ADDRESS=130.180.4.7 


Starts the remote login service for users on the host with IP address 
130.180.4.7. 
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3. TCPIP> ENABLE SERVICE SMTP 


Starts the SMTP receiver. To start the SMTP sender, see the START MAIL 
command. For instructions on how to start the SMTP sender when TCP/IP 
Services starts up, see the SET CONFIGURATION ENABLE SERVICE 


command. 
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EXIT 


Exits from the management program. 


Format 
EXIT 
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EXPORT 


Copies a file from within a container directory to an OpenVMS file. 


Related commands: IMPORT, DIRECTORY 


Format 
EXPORT "/path/name' vms_file_name 


Restrictions 
No wildcards. 


Parameters 


"/path/name" 
Required. 


Specifies the container directory and name of the file you want to copy. 


vms_file_name 
Required. 


Specifies the target OpenVMS file name for the copied file. 


Examples 


1. TCPIP> EXPORT "/upland/sand/piper" USER1$:[BIRDY]JOBS.TXT 


Copies the file piper from the container directory /upland/sand to the regular 
OpenVMS file JOBS.TXT in directory [BIRDY] on disk USER1$:. 
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HELP 

Displays online help for using management commands. 
Format 

HELP [ fopic ] 
Parameters 

topic 

Optional. 


Specifies a specific topic for which to display help. When you enter the HELP 
command without specifying topic, a list of topics is displayed. 
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IMPORT 


Copies an OpenVMS file to a UNIX file located in a container directory. 
Related commands: EXPORT, DIRECTORY 
Applies to: NFS server 


Format 


IMPORT vms_file_name "/path/name" 
[ [NO|JCONVERT ] 
[ /HOST=host ] 
[ NOJLOG ] 
[ /MODE=n ] 
[ /UID=n J 
[ /USER_NAME=vms_user_name ] 


Restrictions 
No wildcards. 


Parameters 


vms_file_name 
Required. 


Name of the file to copy. 
"/path/name" 
Required. 


Specifies the name of the UNIX container directory into which you want to copy 
the file and a file name. 


Qualifiers 


/CONVERT 
/NOCONVERT 
Optional. Default: /CONVERT. 


Converts OpenVMS record files to STREAM_LF files. (The NFS server stores 
UNIX files in STREAM_LF format.) 


/HOST=host 
Optional. 


Selects specific hosts if the proxy database has multiple host entries with the 
same user name and UID. 


/LOG 
/NOLOG 
Optional. Default: Displays values for host, UID, GID, and user name. 


Displays a full description of the specified proxy database record for you to 
determine ownership. 
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/MODE=n 
Optional. Default: 755 (provides the following protection for owner, group, and 
world: rwx-rx-rx). 


Specifies a UNIX protection mask for a new directory. 

Specify octal values in the following order: user, group, others. The values are: 
¢ 0—No access 

e 1— Execute access 

e 2— Write access 

e 3— Write and execute access 

e 4— Read access 

e 5 — Read and execute access 

e 6— Read and write access 

e 7— Read, write, and execute access 


For example, /MODE=751 provides: 


User Read, write, and execute access 1 rwx 
Group Read and execute access 5 rx 
Other Execute access 1 x 
/UID=n 


Optional. Default: Determined with CREATE DIRECTORY. 


Selects a specific entry in the proxy database to determine the ownership of the 
UNIX file. 


In the proxy database: 
e UID and GID fields identify UNIX ownership. 
e User name field identifies OpenVMS ownership. 


If you want to access an entry in the proxy database without a unique UID and 
user name combination, you might need to specify the /HOST qualifier. For 
example, the same UID and user name combination could appear on multiple 
hosts. 


You can use the /UID qualifier in any combination with the /HOST and 
/USER_NAME qualifiers. However, if you do not have SYSPRV or BYPASS 
privilege, the values you specify must correspond to the values for your user 
name in the proxy database. 


/USER_NAME=vms_user_name 
Optional. Default: None. 


Selects a specific entry in the proxy database to determine the ownership of the 
UNIX file. 


The UID and GID fields in this entry establish the file’s UNIX identity, while the 
user name field provides the OpenVMS ownership. 


If you want to access an entry in the proxy database without a unique UID and 
user name combination, you might need to specify the /HOST qualifier. For 
example, the same UID and user name combination could appear on multiple 
hosts. 
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Examples 


If you have SYSPRV or BYPASS privilege and do not specify the /USER_NAME 
qualifier, the proxy record with a UID of 0 and a GID of 1 is selected. 


SYSPRV or BYPASS privilege is required to select a user name that has a UIC 
different from the UIC of the process running the management program. 


You can use the /USER_NAME qualifier in any combination with the /HOST and 
/UID qualifiers. However, if you do not have SYSPRV or BYPASS privilege, the 
values you specify must correspond to the values for your user name in the proxy 
database. 


If you do not specify the /USER_NAME qualifier, the proxy record with a GID of 
1 and a UID of 0 is selected. If there is no proxy entry for the UID of 0, IMPORT 
fails. 


1. TCPIP> IMPORT USER1$:[BIRDY]JOBS.TXT "/upland/sand/piper" 


Copies the file JOBS.TXT to the new file piper in the container directory 
/upland/sand. The file’s ownership depends on the directory information 
specified with the CREATE DIRECTORY command. 
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LIST COMMUNICATION CONTROLLER 


Format 


Parameters 


Qualifiers 


Examples 


Displays the communication controller definitions defined in the configuration 
database. 


Related commands: DEFINE COMMUNICATION_CONTROLLER, 
DELETE COMMUNICATION _CONTROLLER 


LIST COMMUNICATION_CONTROLLER [ controller ] 
[ JNTERNET_INTERFACE=character | 


controller 
Optional. Default: All devices. 


Specifies the OpenVMS device name of communication controller definitions to be 
displayed. 


/INTERNET_INTERFACE=l/etter 
Optional. Default: All alphabetic characters. 


Specifies the first character of the Internet interface name corresponding to the 
communication controller definitions to be displayed. For more information on 
network interfaces, refer to the HP TCP/IP Services for OpenVMS Management 
manual. 


1. TCPIP> LIST COMMUNICATION CONTROLLER 
Communication Controller Configuration 


Controller: LO Internet Interface: L 


Description: 
Type: LOCAL 
Controller: WI Internet Interface: W 
Description: 


Type: WIRELESS 


Controller: EC Internet Interface: C 
Description: 
Type: CLUSTER ETHERNET 


Controller: XE Internet Interface: D 
Description: 
Type: CLUSTER ETHERNET 


Controller: EF Internet Interface: F 
Description: 
Type: CLUSTER ETHERNET 


Controller: CL Internet Interface: I 
Description: ATM Classical IP 
Type: FDDI 


Controller: EL Internet Interface: L 
Description: ATM Emulated LAN 
Type: FDDI 
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Controller: 


Controller: 


Controller: 


Controller: 


Controller: 


Controller: 


Controller: 


Controller: 


Controller: 


TCPIP> 


PP 


EB 


EI 


FA 


FC 


Ic 


IR 


SL 


cL 


Internet Interface: 
Description: 


Type: 


Internet Interface: 
Description: 


Type: 
Internet Interface: 
Description: 
Type: 
Internet Interface: 
Description: 
Type: 
Internet Interface: 
Description: 
Type: 
Internet Interface: 
Description: 
Type: 
Internet Interface: 
Description: 
Type: 
Internet Interface: 
Description: 
Type: 
Internet Interface: 

Description: 
Type: 


P 
Point to Point Protocol 
PPP 


B 
Shared Memory LAN 
CLUSTER ETHERNET 


I 
Fast Ethernet - 182558 
CLUSTER ETHERNET 


A 


CLUSTER FDDI 
c 


CLUSTER FDDI 
Cc 


CLUSTER TOKEN RING 
R 


CLUSTER TOKEN _RING 
S) 


SERIAL 


I 
ATM Classical IP 
FDDI 


Displays all the information in the table used to match OpenVMS device 


names with Internet interface names. 
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LOOP 


Format 


Parameters 


Qualifiers 


Sends ICMP ECHO packets to hosts to determine whether they are active. Same 
as the PING command. 


LOOP [ host] 
[ JADDRESS=xx.xx.xXx.Xxx ] 
[ /ALL ] 
[ /FULL ] 
[ /NUMBER_PACKETS=n ] 
[ /PACKET_SIZE=n ] 
[ /PATTERN="hexadecimal-string" | 
[ [NOJROUTE ] 
[ WAIT=n ] 


host 
Optional. Default: None. 


Specifies the host to which the test packets are sent. Omitting the host parameter 
and the /ADDRESS qualifier tests the TCP/IP Services software on the local node, 
as defined by the system logical TCPIP$INET_HOST. 


/ADDRESS=xx.xx.xx.Xx 
Optional. 


Specifies the IP address of the host to which the test packets are sent. 


/ALL 

Optional. Default: Not all requests. 

Displays all ICMP ECHO_REQUESTs, even if not in direct response to this 
operation. 

/FULL 

Optional. 


Numeric output only. No attempt is made to look up symbolic names for host 
addresses. This occurs only when displaying ICMP packets other than ECHO_ 
RESPONSE. 


/NUMBER_PACKETS=n 
Optional. Default: 4 packets 


Specifies the number of packets to send. If you specify 0, packets are sent 
continuously until you terminate the LOOP command with Ctrl/C. 


/PACKET_SIZE=n 
Optional. Default: 64 bytes. 


Specifies the size of the ICMP ECHO_REQUEST. 
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/PATTERN=hexadecimal-string 
Optional. 


Fills out the packet you send with up to 16 bytes, which is useful for diagnosing 
data-dependent problems. The hexadecimal-string is a string of hexadecimal 
digits of up to 32 characters (16 bytes). 


For example, /PATTERN="ff" causes the sent packet to be filled with ones (1). 


/ROUTE 
/NOROUTE 
Optional. Default: /ROUTE. 
/ROUTE Request is routed through the normal routing tables. 
/NOROUTE Normal routing tables are bypassed. 
If the host is not on the LAN, you get an error. 
/WAIT=n 
Optional. 


Specifies the number of seconds to wait between sending packets. 


Examples 


1. TCPIP> LOOP thrush 
Tests the connectivity path to UNIX host thrush. 


2. TCPIP> LOOP 
Tests the local TCP/IP Services software. 


3. TCPIP> LOOP /NOROUTE thrush 
Tests the path to the UNIX host thrush without using normal routing tables. 
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MAP 


Format 


Restrictions 


Parameters 


Maps (logically links) one of the following to the NFS server: 


e OpenVMS disk — Requires one execution of MAP to map the disk to a UNIX 
path name. 


e Container file system — Requires two executions of MAP. The first maps the 
disk, and the second maps the file system. 


Mapping creates a logical file system, also called an NFS file system. A logical file 
system (with an entry in the export database) is accessible to NFS client users for 
mounting. 


To make a file system available on all nodes of a cluster, map it on each node. 


Mapping is one step in the tasks necessary to give remote users access to a file 
system that physically resides on an OpenVMS host running an NFS server: 


1. Map the file system. 
2. Export the file system (add an entry in the export database). 
3. Give potential users entries in the proxy database. 


MAP settings are not permanent. To map file systems in the permanent 
configuration database, issue SET CONFIGURATION [NO]MAP. 


Related commands: ADD EXPORT, SHOW EXPORT, REMOVE EXPORT, SET 
CONFIGURATION MAP, SET CONFIGURATION NOMAP, SHOW MAP, SHOW 
CONFIGURATION MAP, UNMAP 


MAP "file system name" logical_file_system 


Requires SYSPRV and BYPASS privileges. 


"file system name" 
Required. 


Specifies the name for the file system or disk. In the case of mapping a disk, the 
"/path" can be only one level from the root. This parameter specifies the name by 
which users will access the file system. 


logical_file_system 

Required. 

Specifies the file system to make known to the NFS server. 

To map an OpenVMS file system, specify its disk: 

MAP "/disk" disk: 

To map a container file system, specify the disk and the directory name: 


TCPIP> MAP 
"/container_name" disk:[vms.directory.name] 
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Examples 


1. TCPIP> (TCPIP>)MAP "/usr" CANARYSDUA2: 
Maps local disk CANARY$DUA2: to /usr. This disk can be exported as /usr 
to users on remote NFS clients. 

2. TCPIP> MAP "/remote" VERDINSDUA3: 
TCPIP> MAP "/flyers" VERDINSDUA3: [UNIX BIRD FILES] 


Maps [UNIX_BIRD_FILES], a container file system on disk VERDIN$DUAS:, 
to /flyers. This file system can be exported as /flyers to NFS server users. 
(The first MAP command maps the underlying OpenVMS file system.) 
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MOUNT 


Format 


Makes a physically remote file system accessible to local users. 
Applies to: NFS client 


Mounts a remote directory to local device DNFSn:. Similar in function to the 
UNIX /etc/mount command, MOUNT gives a file system a UNIX path name. (In 
format and style, MOUNT resembles the DCL command MOUNT) 


You can mount either OpenVMS or UNIX file systems. 
Related commands: DISMOUNT, SHOW MOUNT 


MOUNT mount_point | volume_label | [ logical_name | 
[ /HOST=host | 

[ /PATH="/path/name’ | 

[ /ACP_PARAMS=options | 

[ INOJADF[=option] | 

[ /AUTOMOUNT[=INACTIVITY: time] ] 
[ /BACKGROUND[=options] | 

[ /CACHE_TIMEOUT|=options] ] 

[ NO|JCONVERT ] 

[ /DATA=[options] ] 

[ /FILEIDS[=options] | 

[ NO]FORCE ] 

[ /GID=gid | 

[ GROUP ] 

[ OWNER_UIC=n ] 

[ /PROCESSOR=acp_option | 

[ /PROTECTION=protections ] 

[ /RETRIES=n ] 

[ /SERVER_TYPE=type ] 

[ SHARE ] 

[ STRUCTURE ] 

[ NO|SUPERUSER=uid | 

[ SYSTEM ] 

[ TIMEOUT=OpenVMS_delta_time | 
[ /UID=uid } 

[ /USER=user ] 

[ [NOJWRITE ] 


Restrictions and Tips 


If you mount remote OpenVMS directories where the NFS server is running 
TCP/IP Services software, use the /NOADF qualifier on the MOUNT command 
line unless you are using the OpenVMS-to-OpenVMS integration feature. 


The /NOADF requirement applies only if the remote NFS server is running 
versions of TCP/IP Services earlier than Version 3.3 and cannot participate in 
OpenVMS-to-OpenVMS mode operation. Other tips include: 


e For the qualifiers that require a time value, specify OpenVMS delta time. 


e Whenever you specify multiple options and values, use the following syntax: 
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/qualifier=(option_a:value1,option_b:value2,value3) 


Parameters 


mount_point 
Required. 


Local device (and optional directory tree) on which to mount the remote NFS file 
system. Specify this mount point as one of the following: 


DNFSn: 
DNFSn:[dir.subdir] 
DNFSn:[dir.subdir]file 


where: 

n Specifies the unit number. Specify a value from 0 to 9999. 
Specifying 0 causes the client to choose the next available unit 
number. (It does not mount a device named DNFSO:.) 

[dir] or Specifies the directory to mount 


[dir.subdir] (up to eight subdirectories in addition to the [000000] directory). 


file Specifies the individual file to mount. 


volume_label 

Optional. Default: First 12 characters of the combined values of the /HOST and 
/PATH qualifiers. The default label is a combination of /HOST and /PATH with a 
dollar sign ($) separating the two. 


Specifies the Files-11 (ODS-2 or ODS-5) volume label to be associated with the 
remote path name. 

You can use this parameter to provide a unique volume label on a system where 
there is a label conflict. The client does the following: 

e Accepts only the first 12 characters for all other entries. 

e Applies volume_label only on the first mount of a particular disk. 

e Ignores volume_label with subsequent mounts on that disk. 


HP recommends that if you use the SET FILE /STATISTICS command on a file 
mounted with DNFS, do not include any colons (:) in the volume_label. 


logical_name 
Optional. Default: None. 


Specifies the logical name associated with the volume. 
The client creates the following logical definitions, depending on what you specify: 
e Ifyou mount DNFSn:[000000], the client defines the logical name as DNFSn: 


e If you mount DNFSn:|dir.dir], the client defines the logical name as 
DNFSn:[dir.dir.| The extra dot allows for relative directory specifications. If 
you issue the following command: 


$ SET DEFAULT logical: [subdir] 
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The full default definition becomes: 
DNFSn:[dir.dir.subdir] 


The client places the logical name in the SYSTEM logical name table, unless you 
specify the /GROUP or /SHARE qualifier. The client deletes the logical name 
from the SYSTEM table when you dismount the volume. The process must 
have SYSNAM privilege to mount a system mount point. Without SYSNAM or 
GRPNAM privilege, the user must specify /SHARE for a JOB mount. (See the 
/SHARE qualifier for more information.) 


/ACP_PARAMS= 

{ BUFFER_LIMIT=n | DUMP | IO_DIRECT=n | IO_BUFFERED=n | 
MAX_WORKSET=pages | PAGE_FILE=file | PRIORITY=base-priority | 
WORKSET=pages } 

Optional. 


Specifies modifiable process parameters for the ancillary control process (ACP). 


These parameters are dynamic. The NFS client applies your settings at each first 
start of an ACP. 


For descriptions of these options, see the section on RUN (PROCESS) in the 
OpenVMS DCL Dictionary. 


/ADF=CREATE 
/NOADF 
Optional. Default: /ADF=CREATE. 


If attributes data files (ADFs) exist on the NFS server, the /ADF qualifier lets you 
use them. 


The server uses ADFs to store OpenVMS file attributes. These files appear on the 
server as .SADF$file files, but you cannot view them directly on the local client 
system. 


The option is: 
e CREATE 

The client uses and updates the ADFs, and creates ADFs for new files. 
/NOADF — No ADFs are created or used. 


/AUTOMOUNT[=INACTIVITY: time] 
Optional. Defaults: 


e If you omit this qualifier, automounting is not enabled for this file system. 


e If you include the /AUTOMOUNT qualifier but omit the INACTIVITY 
keyword, file systems are automatically dismounted after five minutes of 
inactivity. 

This qualifier enables automounting for the file system. The file system is 

automatically mounted when you access its path name. 


You can include the optional INACTIVITY keyword to specify the number of 
minutes of inactivity before automatically dismounting the file system. Be sure to 
specify the time as hh:mm:ss. When this inactive period expires, the NFS client 
dismounts the path name. 
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/BACKGROUND [= {DELAY: OpenVMS_delta_time | RETRY:n}] 
Optional. Defaults: 


e If you omit this qualifier, background mode mounting is not attempted. 


e If you omit the DELAY keyword, background mode mounting is set up with 
/BACKGROUND=(DELAY:00:00:30,RETRY:10). 


This qualifier enables background mode for mounting the file system. 


The optional DELAY time specifies amount of time to wait if the mount attempt 
fails before trying again. Specify the time as hh:mm:ss. The maximum delay 
period you can specify is approximately 49 days. The default delay time is 30 
seconds. 


The optional RETRY keyword specifies the number of times to repeat the attempt 
to mount the file system. RETRY:0 means that the client uses the first try only. 
The default number of times to retry is 10. 


If you use the /BACKGROUND qualifier, you must also use the /RETRIES 
qualifier and specify a nonzero value. For example: 


$ TCPIP MOUNT DNFSO: /BACKGROUND=RETRY:9 /RETRIES=4 /HOST="robin" - 
_$  /PATH="/USR/USERS/GEORGE" 


In this example, you are asking for four data retries on each mount attempt 

and nine mount attempts, for a total of 36 tries. If you use the default value for 
/RETRIES, the first mount attempt can never complete except by succeeding, and 
the process doing the mount will hang until the server becomes available. 


/CACHE_TIMEOUT= 

[ DIRECTORY: OpenVMS_delta_time | 
[ ATTRIBUTE: OpenVMS_delita_time ] 
[ READ_DIRECTORY ] 

Optional. Defaults: 


If you omit this qualifiier, the file system is set up with caching timeouts as 
follows: 


/CACHE_TIMEOUT=(DIRECTORY: 00:00:30,ATTRIBUTE: 00:00:15) 
Specifies the following caching timeout information for the mount point: 
e DIRECTORY:OpenVMS_delta_time 


— Amount of time that the client waits between rereading a directory’s 
status or contents. 


— Specify OpenVMS_delta_time as hh:mm:ss. 
e ATTRIBUTE:OpenVMS_delta_time 


— Amount of time that the client waits between rereading a file’s attributes 
from the NFS server. 


— Specify OpenVMS_delta_time as hh:mm:ss. 
e READ_DIRECTORY 


— Forces the client to read the contents of the directory requested when the 
cache timeout occurs rather than rely on the directory’s modified time. 
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— By reading the directory contents, the client can be aware of any changes 
to the number of files within the directory, even if the directory’s modify 
time was not updated. 


/CONVERT 
/NOCONVERT 
Optional. Default: /CONVERT. 


Converts files with the following attributes to STREAM _LF files: 
e Sequential 

e Variable length 

e Carriage return/carriage control (VAR-CR) 


The convert feature works with some utilities and DCL commands but not with 
others. For example, it works with the CREATE command and with EDIT/TPU, 
but it does not work with COPY, BACKUP, or EDIT/EDT. There is no simple 
way to identify what works. However, for the feature to take effect, the following 
conditions must be satisfied: 


e The file attributes must be sequential, variable length, and carriage 
return/carriage control. 


e The file must be opened for exclusive write access (generally true for newly 
created files). 


e The file must be opened with the FAB$M_SQO bit set in the FAB$L_FOP 
field. 


e The file creation and the open for write must be done in one step. That is, if 
the program first creates the file and afterward opens it for write, the convert 
feature does not work. 


You can convert only those files that were opened using RMS sequential access. 
For additional information, refer to the HP TCP/IP Services for OpenVMS 
Management manual. 


/DATA [= {read_bytes | write_bytes}] 
Optional. Default: /DATA=(8192,8192). 


Largest amount of NFS data received or transmitted in one network operation. 
The options mean: 


e read_bytes — Data received. Minimum value = 512. 
e write_bytes — Data transmitted. Minimum value = 512. 
If you specify only one value, it applies to both READ and WRITE. 


You do not need to use /DATA unless a remote NFS server imposes a restriction 
on data size. If the server requests a smaller transfer size than you specified, the 
server’s requested value overrides the one you set. 


/FILEIDS [= {UNIQUE | NONUNIQUE}] 
Optional. Default: /FILEIDS=UNIQUE. 


With UNIQUE, the client uses the file name and 32-bit NFS file ID when 
processing the directory information returned by the server to determine whether 
cached information is valid. 
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With NONUNIQUE, the client uses the file handle instead of the file ID. This 
can refresh directory entries in the client’s cache more quickly. However, this can 
degrade performance because the client must issue additional RPC requests to 
get the file handle. 


/FORCE 
/NOFORCE 
Optional. Default: /NOFORCE. 


Performs an overmount or a mount that can cause file system occlusion. 
Required privileges: 

e OPER 

e SYSPRV (for overmounting a /SYSTEM mount) 

e GRPNAM (for overmounting a /GROUP mount) 


/GID=n 
Optional. Default: —2. 


Default GID if no GID mapping exists for file access. 
Restriction: Requires OPER privilege. 


/GROUP 
Optional. Default: User mounted. 


Adds the logical name to the group logical name table. If the mount is the first 
one on the volume, /GROUP marks the volume as being group-mounted. 


Restrictions: 
e Requires GRPNAM privilege. 
e /GROUP and /SYSTEM are mutually exclusive. 


/HOST=host 
Required. 


Remote NFS server on which the physical files reside. Type either domain-name 
or IP-address format. 


/OWNER_UIC=n 
Optional. Default: Ownership recorded on the volume. 


UIC-assigned ownership of the volume while you mount it. 


Applied only on the first mount of an NFS disk. 


/PATH="/path/name" 
Required. 


Path name on the NFS server (specified by /HOST). Must match an exported 
directory, subdirectory, or file of an exported file system on the server. 


The /path/name is mounted as the master file directory (MFD) of the specified 
device. 


/PROCESSOR= {UNIQUE | SAME:DNFSn: | FILE: file} 
Optional. Default: New ACP for each mount. 
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Associates an ancillary control process (ACP) to process the volume, overriding 
the default manner in which the client associates ACPs with NFS devices 
(starting a new ACP for each mount request). The options are: 


e UNIQUE 
— Creates a new ACP for the new NFS device. 
— Requires OPER privilege. 

e SAME:DNFSn: 
— Uses the same ACP as the specified device. 
— Requires OPER privilege. 

e FILE;file 


— Creates a new ACP running the image specified by file. Do not use 
wildcards, host names, or directory names. 


— Requires CMKRNL or OPER privilege. 


/PROTECTION=protections 
Optional. Default: /PROTECTION=(S:RWED,O:RWED,G:RWED,W:RWED). 


Protection code for the volume. If you omit a category, the client denies access to 
that category of user. 


Applied only on the first mount of an NFS device and ignored with subsequent 
mounts on that device. 


Restrictions: Requires OPER privilege. 


/RETRIES=n 
Optional. Default: /RETRIES=0 (the client retries the request forever or until the 
server responds). 


Maximum number of read or write retries if the NFS server fails to respond. 


/RETRIES=0 is a close equivalent to a UNIX hard mount. If you attempt to abort 
a command or program while it is still retrying the I/O operation on a client 
device, the process enters RWAST state and remains in that state until the NFS 
server responds. A process in RWAST state cannot be terminated. If the server 
does not become available, the only way remove the process without rebooting the 
client host is to dismount the client device with the /ALL qualifier. 


/SERVER_TYPE=type 
Optional. Default: UNIX. 


Operating system of the host running NFS server. The values for type are: 
e UNIX 
e IBM_VM 


If the server is TCP/IP Services Version 3.3 or later, this qualifier is ignored 
because the client and server always operate in OpenVMS-to-OpenVMS mode. 


/SHARE 

Places the logical name in the job logical name table and increments the volume 
mount count regardless of the number of job mounts. When the job logs out, all 
job mounts are dismounted, causing the volume mount count to be decremented. 
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Refer to the HP TCP/IP Services for OpenVMS Management manual for more 
information. 


/STRUCTURE 
Optional. Default: /STRUCTURE=2 


Specifies whether the volume should be formatted in Files-11 On-Disk Structure 
Level 2 (ODS-2), which is the default, or Files-11 On-Disk Structure Level 5 
(ODS-5). 


For more information about ODS-5 disks, refer to the HP OpenVMS System 
Manager’s Manual: Essentials. 


/SUPERUSER=uid 
/NOSUPERUSER 
Optional. Default: /NOSUPERUSER. 


Maps users with SYSPRV, BYPASS, or READALL privileges to the superuser 
UID. The NFS server must allow superuser access. 


The normal superuser UID is 0. 
/NOSUPERUSER: No mapping. 


/SYSTEM 
Optional. Default: System mounted. 


Places the logical name in the system logical name table unless you specify 
the /GROUP or /SHARE qualifier. The client deletes the logical name from the 
system table when you dismount the volume. 


Restrictions: 

e Requires SYSNAM privilege. 

e The /GROUP, /SYSTEM, and /SHARE qualifiers are mutually exclusive. 

e Without SYSNAM or GRPNAM privilege, you must use /SHARE for a job 
mount. 

/TIMEOUT=OpenVMS_delta_time 

Optional. Default: ::01 (1 second). 


Minimum timeout period for initial remote procedure call (RPC) request 
retransmissions. 


Specify the timeout period as your estimate of the typical round-trip time for RPC 
requests. For slower-speed links — for example, NFS traffic over SLIP — specify 
a value that is larger than the default. 


Example: For a maximum read/write size of 8192 (see the /DATA qualifier) over 
a 19,200-baud SLIP line, set the absolute minimum timeout value as follows: 
10240 bytes*8 bits per byte 
--------------------------- = 4.27 seconds 

19,200 bits per second 
Here, the 10240 bytes is 8192 data bytes plus the worst-case RPC overhead. 
Because 4.27 seconds is the absolute minimum, a more realistic value for this 
link is 15 to 30 seconds to allow for other traffic. 


/UID=n 
Optional. Default: —2. 
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Default UID if no UID mapping exists for file access. 
Restriction: Requires OPER privilege. 


Both the NFS server and NFS client use the proxy database for access control. 
HP strongly recommends that you provide a proxy with a unique UID for every 
NFS client user. 


If you need to provide universal access to world-readable files, you can use the 
default UID to avoid creating a proxy for every NFS client user. You should 
avoid using the default UID if clients require additional file access; otherwise, 
client users may see unpredictable and confusing results when they try to create 
files. Refer to the HP TCP/IP Services for OpenVMS Management manual 

for a detailed discussion about using proxies, the default user, and security 
considerations. 


/USER=user 
Optional. Default: USER account. 


Existing OpenVMS account to which the NFS client maps unknown UIDs. 


If the client does not find the USER account, the DECnet account becomes the 
default. If the client does not find the DECnet account, [200,200] becomes the 
default. 


/WRITE 
/NOWRITE 
Optional. Default: /WRITE. 


Mounts files with WRITE privilege. 
/NOWRITE mounts files as read only. 


1. TCPIP> MOUNT DNFS2: /HOST="loon" /PATH="/usr/users/curlew" 


Mounts, on local device DNFS2:, the remote directory /usr/users/curlew, 
which resides on NFS server loon. 


2. TCPIP> MOUNT DNFS3: /HOST="sigma" - 
_TCPIP> /PATH="/usr" /AUTO=(INACT:00:10:00) 


Using automounting, this command mounts the /usr file system from sigma 
onto the OpenVMS mount point when it references the path name. The client 
keeps the path mounted for an inactive period of 10 minutes, after which it 
dismounts the path name. 


3. TCPIP> MOUNT DNFS4: /HOST="sigma" /PATH="/usr" - 
_TCPIP> /BACKGROUND=(DEL:00:01:00,RET:20) /RETRIES=4 
Attempts to mount the /usr file system. If it cannot, it waits 1 minute and 
retries the connection up to 20 times. 

4, TCPIP> MOUNT DNFS5:[USERS.MNT] /HOST="sigma" /PATH="/usr" 
SDNFSMOUNT-S-MOUNTED, /usr mounted on _DNFS5:[USERS.MNT] 


TCPIP> MOUNT DNFS5:[USERS.MNT] /HOST="sigma" /PATH="/usr/users" /FORCE 
SDNFSMOUNT-S-REMOUNTED, _DNFS5:[USERS.MNT] remounted as /usr/users on SIGMA 


Specifies a lower level in the NFS server path with the second mount. This 
constitutes another path name and qualifies for an overmount. 
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TCPIP> MOUNT DNFS22:[USERS.SMITH.MNT] /HOST="sigma" /PATH="/usr" 
SDNFSMOUNT-S-MOUNTED, /usr mounted on _DNFS22:[USERS.SMITH.MNT] 


TCPIP> MOUNT DNFS22:[USERS.SMITH] /HOST="sigma" /PATH="/usr" /FORCE 
SDNFSMOUNT-S-MOUNTED, /usr mounted on _DFS22:[USERS.SMITH] 
sTCPIP-I-OCCLUDED, previous contents of DNFS22:[USERS.SMITH] occluded 


The /FORCE qualifier performs an occluded mount. If you issue the 
DIRECTORY command, the NFS client occludes (hides from view) the 
subdirectory dropped from the first MOUNT command. 


To make the directory visible again, either issue the SHOW 
MOUNT command (both mounts will be visible) or dismount 
DNFS22:[(USERS.SMITH]. 


TCPIP> MOUNT DNFS0: BOOK1 BEATRICE - 
TCPIP> /PATH="/INFERNO" - 

“TCPIP> /HOST="FOO.BAR.EREWHON" - 

“TCPIP> /STRUCTURE=5 - 

“TCPIP> /SYSTEM 


Mounts path INFERNO with label BOOK1 and logical name BEATRICE. 
Specifies the volume structure as ODS-5. 
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PING 


Format 


Parameters 


Qualifiers 


Sends ICMP ECHO packets to hosts to determine whether they are active. Same 
as the LOOP command. 


PING [ host ] 
[ JADDRESS=xx.xx.xXx.Xxx ] 
[ /ALL ] 
[ /FULL ] 
[ /NUMBER_PACKETS=n ] 
[ /PACKET_SIZE=n ] 
[ /PATTERN="hexadecimal-string" | 
[ [NOJROUTE ] 
[ WAIT=n ] 


host 

Specifies the host to which the test packets are sent. 

Omitting host tests the TCP/IP Services software on the local node, as defined by 
the system logical TCPIP$INET_HOST. 


/ADDRESS=Xxx.xx.xXx.xX 
Optional. 


Specifies the IP address of the host to which the test packets are sent. 


/ALL 

Optional. Default: Not all requests. 

Displays all ICMP ECHO_REQUESTs, even if not in direct response to this 
operation. 

/FULL 

Optional. 


Numeric output only. No attempt is made to look up symbolic names for host 
addresses. This occurs only when displaying ICMP packets other than ECHO_ 
RESPONSE. 


/NUMBER_PACKETS=n 
Optional. Default: 4 packets 


Specifies the number of packets to send. If you specify 0, packets are sent 
continuously until you terminate it with Ctrl/C. 


/PACKET_SIZE=n 
Optional. Default: 64 bytes. 


Specifies the size of the ICMP ECHO_REQUEST. 


/PATTERN= “hexadecimal-string" 
Optional. 
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Fills out the packet you send with up to 16 bytes, which is useful for diagnosing 
data-dependent problems. The string is a hexadecimal string of up to 32 
characters (16 bytes). 


For example, /PATTERN="ff" causes the sent packet to be filled with ones (1). 


/ROUTE 
/NOROUTE 
Optional. Default: /ROUTE. 
/ROUTE Request is routed through the normal routing tables. 
/NOROUTE Normal routing tables are bypassed. 
If the host is not on the LAN, you get an error. 
IWAIT=n 
Optional. 


Specifies the number of seconds to wait between sending packets. 


Examples 


1. TCPIP> PING dented 
Specifies that the local host test the connectivity path to host dented. 
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REMOVE DIRECTORY 


Removes a link to a directory within a UNIX container directory. If there are no 
other links to it, the directory is deleted. 


Related commands: CREATE DIRECTORY, DIRECTORY 
Applies to: NFS server 


Format 
REMOVE DIRECTORY "/path/name' 


Restrictions 
Requires: 
e Read and write access to the parent directory 
e BYPASS privilege 


Parameters 


"/path/name" 
Required. 


Directory with the link you want to remove. 


Examples 


1. TCPIP> REMOVE DIRECTORY "/eagles/eaglet" 


Removes a link to the directory /eagles/eaglet. 
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REMOVE EXPORT 


Deletes directory names from the export database so that they are not available 
for mounting by an NFS client. 


Related commands: ADD EXPORT, SHOW EXPORT, MAP, SET 
CONFIGURATION MAP, SET CONFIGURATION NOMAP, SHOW MAP, SHOW 
CONFIGURATION MAP 


Applies to: NFS server 


Format 
REMOVE EXPORT "/path/name" 
[ [NO|CONFIRM ] 
[ /HOST=host ] 
Restrictions 
Requires read and write access to the export database. 
Parameters 
"/path/name" 
Required. 
Directory name to delete from the export database. 
Qualifiers 
/CONFIRM 
/NOCONFIRM 


Optional. Default: /CONFIRM if you use a wildcard. 


When the software encounters a match, it displays a description and solution. If 
/CONFIRM is enabled, the software then requests confirmation before deleting 
each directory name. Enter one of the following: 


e Y to delete the name 
e N to retain the name 


If you specify the /NOCONFIRM qualifier, the operation is performed without 
asking you to confirm the request. 


/HOST=host 
Optional. Default: /HOST=* (all hosts). 


Host, running NFS client, that will become unable to access the specified 
container directory. 


Format for multiple hosts: 
/HOST=("host0","host1", "host2") 
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Examples 


1. TCPIP> REMOVE EXPORT "/house/finch" 
Removes the name of container directory /house/finch from the export 
database. This directory is now inaccessible to NFS client users. 

2. TCPIP> REMOVE EXPORT "/oceans/swamps" /HOST=("tern","crane") 


Modifies the accessibility of local UNIX directory /oceans/swamps. This 
directory is now unavailable to users working on hosts tern and crane, which 
run NFS client software. 
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REMOVE FILE 


Removes a link to a file within a container directory. If there are no other links 
to it, the file is deleted. 


Related commands: DIRECTORY, REMOVE DIRECTORY 
Applies to: NFS server 


Format 
REMOVE FILE "/path/name' 


Restrictions 
Requires: 
e Read and write access to the parent directory 
e BYPASS privilege 


Parameters 


"/path/name" 
Required. 


File with the link you want to remove. 


Examples 


1. TCPIP> REMOVE FILE "/peacock/feather.care/preening" 


Removes the NFS link to the file preening. 
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REMOVE MAIL 


Format 


Restrictions 


Parameters 


Qualifiers 


Deletes mail messages from SMTP queues. 


Without the user parameter, all messages from the user name that correspond to 
your process’s user name are deleted. 


Related commands: SEND MAIL, SHOW MAIL 
Applies to: SMTP 


REMOVE MAIL [ user ] 
[ [NO|COPY=[directory] ] 
[ INO]JCONFIRM |] 
[ /ENTRY=n ] 


Requires SYSPRV or BYPASS privilege for mail messages that are not yours. 


user 
Optional. Default: All mail messages with your process’s user name. 


Removes messages sent from the specified user name. 


/COPY=[directory] 
/NOCOPY=[directory] 
Optional. Default: Messages copied to the user’s default directory. 


Copies messages to be deleted to the specified directory. 
/NOCOPY: Messages are not copied. 


/CONFIRM 
/NOCONFIRM 
Optional. Defaults: 


e With an entry number specified — /NOCONFIRM 
e Without an entry number specified — /CONFIRM 


If you specify /CONFIRM, or if you omit an entry number, requests confirmation 
before deleting each message. Respond to the CONFIRM: prompt by entering one 
of the following: 


e Y to delete the mail message 
e N to retain the mail message 
e Gto change to NO CONFIRMATION mode 


If you specify the /NOCONFIRM qualifier or an entry, the operation is performed 
without asking you to confirm the request. 
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/ENTRY=n 
Optional. Default: All. 


Queue entry numbers to remove from the SMTP queue. 


Examples 


1. TCPIP> REMOVE MAIL 


Removes all messages for your process’s user name, or deletes everything in 
the SMTP queue if you have either SYSPRV or BYPASS privilege. 


2. TCPIP> REMOVE MAIL /ENTRY=781 


Removes message 781, if it corresponds to your process’s user name, or if you 
have either SYSPRV or BYPASS privilege. 


3. TCPIP> REMOVE MAIL BROOD 
Removes all messages for BROOD, if your process’s user name is BROOD, or 
if you have either SYSPRV or BYPASS privilege. 

4. TCPIP> REMOVE MAIL /USER_NAME=COCKATOO /COPY=[COCKATOO.OLD MATL] 


Removes all messages for COCKATOO, if this is your process’s user name, or 
if you have either SYSPRV or BYPASS privilege. Before deletion, copies this 
queued mail to the specified directory. 
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REMOVE PROXY 


Format 


Restrictions 


Parameters 


Qualifiers 


Deletes entries from the volatile and permanent proxy database. 
Related commands: ADD PROXY, SHOW PROXY 


Applies to: NFS server, NFS client, PC-NFS, remote shell, LPR/LPD, and 
customer-developed services 


REMOVE PROXY [ user_name ] 
[ COMMUNICATION ] 
[ INO|CONFIRM |] 
[ /GID=n ] 
[| /HOST=host ] 
[ /NFS=options ] 
[| /PERMANENT } 
[ /REMOTE_USER=user | 
[ /UID=n | 


Requires: 
e Read and write access to the proxy database 
e One of the following privileges: 

- SYSPRV 

- SYSLCK 

—- OPER 


user_name 
Optional. Default: All entries (REMOVE PROXY *). 


Deletes the specified entries from the proxy database. 


/COMMUNICATION 
Optional. Default: Both communication and NFS entries. 


Deletes communication (non-NFS) proxies. 


/CONFIRM 
NOCONFIRM 
Optional. Default: /CONFIRM if you use a wildcard. 


With /CONFIRM enabled, the software requests confirmation before deleting 
records. At the CONFIRM: prompt, enter one of the following: 


e Y to delete the entry 
e N to retain the entry 


e Gto change to NO CONFIRMATION mode 
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If you specify the /NOCONFIRM qualifier, the operation is performed without 
asking you to confirm the request. 


/GID=n 
Optional. Default: All GIDs. 


Deletes only proxies for the specified group identifier (GID). 


/HOST=host 
Optional. Default: All hosts. 


Deletes only proxies for the specified host. 


/NFS=INCOMING 
/NFS=OUTGOING 
Optional. Default: /NFS=INCOMING,OUTGOING). 


Deletes an NFS proxy. Specify one of the following: 


/NFS=OUTGOING Proxy to use NFS client 
/NFS=INCOMING Proxy to use NFS server 
/NFS=(OUTGOING,INCOMING) Proxy to use NFS client and NFS server 


/PERMANENT 
Optional. Default: None. 


Deletes entries only from the permanent proxy database. 


/REMOTE_USER=user 
Optional. Default: None. 


Deletes entries for the specified remote user name. 


/UID=n 
Optional. Default: All UIDs. 


Limits the search of entries to delete to proxies for the specified UID. 
Examples 


1. TCPIP> REMOVE PROXY "peacock" /HOST=GOLDEN /UID=83 


Removes authorization for UID 83 on host GOLDEN from OpenVMS account 
peacock. 


2. TCPIP> REMOVE PROXY /HOST=GOLDEN /UID=83 
Removes authorization for UID 83 from host GOLDEN. 


3. TCPIP> REMOVE PROXY /HOST=("goose","grouse") 


Removes authorization for all users on hosts goose and grouse. 


4, TCPIP> REMOVE PROXY /UID=83 


Totally removes authorization for UID 83. 


5. TCPIP> REMOVE PROXY VMS_USER /REMOTE=PARTRIDGE /HOST=* 


Removes authorization for remote user PARTRIDGE on all hosts. 
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SEND MAIL 


Format 


Restrictions 


Parameters 


Qualifiers 


Requeues a mail message for delivery. Releases jobs that are in a hold state. 
Related commands: REMOVE MAIL, SHOW MAIL 
Applies to: SMTP 


SEND MAIL. [ user ] 
[ /AFTER=time ] 
[ INO|CONFIRM ] 
[ /ENTRY=n ] 


SYSPRV or BYPASS privilege required to requeue mail messages that do not 
correspond to your process’s user name. 


user 
Optional. Default: All. 


Requeues messages sent from the specified user name. 


/AFTER=time 
Optional. Default: Immediate delivery attempt. 


Time after which delivery is to be attempted. 


/CONFIRM 
/NOCONFIRM 
Optional. Defaults: 


e With an entry number specified — /NOCONFIRM 
e Without an entry number specified — /CONFIRM 


With /CONFIRM enabled, the software requests confirmation before deleting each 
message when you omit an entry number. At the CONFIRM: prompt, enter one 
of the following: 


e Y to delete the message 
e N to retain the message 
e Gto change to NO CONFIRMATION mode 


With /NOCONFIRM enabled, the operation is performed without asking you to 
confirm the request. 


/ENTRY=n 
Optional. 


Queue number of the mail message to be re-queued for delivery. 
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SET ARP 


Formats 


Restrictions 


Parameters 


Qualifiers 


Provides the dynamic mapping from an IP address to the corresponding physical 
network address (hardware address) on an FDDI, Ethernet, or Token Ring LAN 
segment. 


SET NOARP removes an address-mapping pair (IP address to physical network 
address). 


Related command: SHOW ARP 


SET ARP mac_address host 
[ /[NOJPERMANENT ] 
[ [NO]PUBLIC ] 


SET NOARP _ [hostj 


Requires OPER privilege. 


mac_address 
Required. 


Specifies the physical network adddress (the hardware address) on an FDDI, 
Ethernet, or Token Ring LAN segment to be mapped to an IP address. 


For mac_address, specify hh-hh-hh-hh-hh-hh, where hh are pairs of hexadecimal 
digits. 

host 

Required. 


Specifies the host on the targeted LAN segment. If you do not supply a host 
name, you must supply its corresponding IP address. 


/PERMANENT 
/NOPERMANENT 
Optional. Default: /PERMANENT. 


Specifies whether the mapping information is cached. 
/NOPERMANENT removes ARP mapping after the caching interval. 
Not valid with SET NOARP. 

/PUBLIC 


/NOPUBLIC 
Optional. Default: /PUBLIC. 


Specifies whether the local ARP responds to ARP requests from other hosts to the 
specified host. 


/NOPUBLIC maps only for the local host. 
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Not valid with SET NOARP. 


Examples 


1. TCPIP> SET ARP AA-BB-04-05-06-07 CONDOR 


Permanently maps CONDOR’s host name to FDDI address 
AA-BB-04-05-06-07. 
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SET BOOTP 


Format 


Restrictions 


Parameters 


Qualifiers 


2-86 Command 


Creates client entries in the BOOTP database. 
SET NOBOOTP does not require any qualifiers. 
Related commands: CONVERT/VMS BOOTP, SHOW BOOTP 


SET [NO]JBOOTP host 
[ /FILE=file| 
/HARDWARE=ADDRESS=hex_address 
[| /GATEWAYS=hosts | 
[ /NETWORK_MASK=/P_address | 
[ /SERVERS=type=host | 
[ /TIME_OFFSET=seconds ] 


Requires read, write, and delete access to the BOOTP database. 


host 
Required. 


Specifies the client to which your system will download files upon request. Enter 
a host name or IP address. 


/FILE=file 
Optional. 


Specifies the name of the client’s system image or other file to download upon 
request. 


e By default, upon receiving a request, BOOTP looks for this file in 
TCPIP$TFTP_ROOT:|[host], where host is the client’s host name, excluding 
the domain. 


e If this directory does not exist, BOOTP uses: 
TCPIPSTFTP_ROOT: [000000]. 


e When the TCP/IP Services software receives a boot request, BOOTP verifies 
the existence and size of this file. 


/GATEWAYS=hosts 
/INOGATEWAYS=hosts 
Optional. Default: None. 


Specifies the gateways used for routing. 


/HARDWARE=ADDRESS=hex_adadr 
Required. 


Specifies the client’s hardware address. For hex_addr, specify: hh-hh-hh-hh-hh- 
hh. 


Descriptions 


Examples 


SET BOOTP 


/NETWORK_MASK=!P_address 
Required if you use subnets; otherwise optional. 


Specifies the part of the host field of an IP address identified as the subnet. 
The software calculates the default by setting the following: 

e The bits representing the network field to 1 

e The bits representing the host field to 0 


You can divide the host field into a site-specific subnetwork and a host field. If 
you use subnets, you must specify a subnet field. 


/SERVERS=type=host 
Optional. 


Specifies other servers whose names BOOTP can supply to clients. Here, host 
specifies a host name or IP address and type can be one or more of the following: 


[NO]COOKIE Cookie server 
[NO] TEN NAME IEN-116 name server 
[NO]IMPRESS Impress network image server (IMAGEN) 
[NO]LPR Berkeley 4BSD print server 
[NO]LOG MIT-LCS UDP logging server 
[NO]INAME BIND name server 
[NO]RESOURCE Resource Location Protocol 
(RLP) server (RFC-887) 
[NO]TIME Internet time server (RFC-868) 


/TIME_OFFSET=seconds 
Optional. Default: 0 seconds. 


Specifies the time difference, in seconds, between the client’s time zone and 
Universal Coordinated Time (UTC) expressed in seconds. This value is zero (0) in 
the British Isles and parts of Europe, a positive number for locations east of the 
zero meridian, and a negative number for locations west of the zero meridian. 


1. TCPIP> SET BOOTP PLOVER /HARDWARE=ADDRESS=08-00-2D-20-23-21 - 
_TCPIP> /FILE=PLOVER. SYS 
Adds client host PLOVER, with hardware address 08-00-2D-20-23-21 to the 
BOOTP database. BOOTP can respond to a remote boot request from client 
PLOVER with a reply packet containing the name of the file to down load and 
its IP address. 


2. TCPIP> SET BOOTP ERN /HARDWARE=ADDRESS=98-00-2D-20-23-21 - 
_TCPIP> /SERVERS=COOKIE= (PLOVER, GULL) 
Adds client host ERN to the BOOTP database and specifies that ERN will use 
PLOVER AND GULL as cookie servers. 
3. TCPIP> SET BOOTP PLOVER /HARDWARE=ADDRESS=08-00-2D-20-23-21 - 
_TCPIP> / SERVERS= (COOKIE=GULL, NAME=BIRDS ) 


Adds client host PLOVER to the BOOTP database and specifies that PLOVER 
will use GULL as a COOKIE server and BIRDS as its name server. 
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SET COMMUNICATION 


Format 


Restrictions 


Qualifiers 


Modifies the IP, TCP, UDP, and INET_ACP software on the running system. 


Related commands: SET CONFIGURATION COMMUNICATION, SHOW 
COMMUNICATION 


SET COMMUNICATION [ /ACCEPT=options | 


[ /DOMAIN=domain | 

[ /LOCAL_HOST=host ] 
[ /PROXIES=n ] 

[ /REJECT=options | 


Requires OPER privilege. 


/ACCEPT { =[NOJHOSTS=(hosis) | =|[NO]JNETWORKS=(networks) } 
Optional. Default: All hosts and all networks. 


Accepts communication from the hosts and networks specified. 
Do not specify the same hosts or networks for both /ACCEPT and /REJECT. 


To delete an /ACCEPT entry, specify it again using the NOHOSTS or 
NONETWORKS option. 


Specify one of the following: 


[NO]HOSTS=hosts 
Hosts that can access TCP/IP Services. Maximum is 32. For example: 
/ACCEPT=HOSTS=(host1_name,host2_name, host3_address) 


[NO]NETWORKS=networks 

Networks that can access TCP/IP Services. Maximum is 16. 
Use the following syntax: 
NETWORKS=(net1/:net1mask/],net2/:net2mask/....) 


For each network, specify: network:[network_mask]. The network mask is 
optional. (Default: class number of your network. For example, the default 
for 11.200.0.0. is 255.0.0.0.). For example: 


/ACCEPT=NETWORKS=(net1_name,net2_addr,net3_addr:net3_mask) 


/DOMAIN=domain 
Optional. 


Specifies your system’s local domain. This qualifier requires either SYSPRV or 
BYPASS privilege. 


/LOCAL_HOST=host 
Optional. 
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Defines the following logical names for the local host: 
e TCPIP$INET _HOST=host-name 


This logical is always set with the primary host name even if the alias name 
was specified as host. 


e TCPIP$INET_HOSTADDR=host-IP-address 


If the local host has multiple IP addresses, this logical name is set with a 
name for each address, called TCPIP$INET_HOSTADDRn, where n is a 
number starting at 2. 


This qualifier requires either SYSPRV or BYPASS privilege. 


/PROXIES=n 
Optional. Default: Number of communication proxies plus 10, with a minimum 
of 20. 


Specifies the maximum size of the proxy cache. If you plan to add entries to the 
proxy database after you start the TCP/IP Services software, set /PROXIES to a 
value higher than the default. 


You cannot change this value if the TCP/IP Services software is running. 


/REJECT {=[NOJHOSTS=(hosts) | =[NO]JNETWORKS=(networks) | 
=[NO]MESSAGE=(message) } 
Optional. Default: No rejections. 


Specifies the hosts or networks that cannot access the TCP/IP Services software, 
including the rejection message that TCP/IP might return. 


(For remote login, remote shell, and remote executive, the rejection message is 
preceded by a byte with a value of 1 and terminated by a byte with a value of 
zero.) 


Do not specify the same hosts or networks for both /ACCEPT and /REJECT. 


To delete a /REJECT entry, specify it again using the NOHOSTS or 
NONETWORKS option. 


Specify one of the following: 


e [NO]HOSTS=Aosts to list hosts that cannot access TCP/IP Services. 
Maximum is 32. The syntax is: 


/REJECT=HOSTS=(host1_name,host2_name,host3_address) 


e [NO]JNETWORKS=networks to list networks that cannot access TCP/IP 
Services Maximum is 16. The syntax is: 


NETWORKS=(net1/:net1mask/],net2/:net2mask/,... ) 


For each network, specify network:network_mask. The network mask is 
optional. Default: Class number of your network. For example, the default 
for 11.200.0.0. is 255.0.0.0. The syntax is: 


/REJECT=NETWORKS=(net1_name,net2_address ,net3_addr:net3_mask) 


1. TCPIP> SET COMMUNICATION - 
_TCPIP> /REJECT=NETWORK=(16.30.0.0:255.255.0.0,16.40.0.0:255.255.0.0) 


Sets all the services to be inaccessible to the two specified networks. 
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SET CONFIGURATION BIND 


Format 


Restrictions 


Qualifiers 


2-90 Command 


Configures the BIND name server. Creates the BIND server configuration file, 
which holds the following information: 


e Cluster alias or aliases 

e Server type (primary, secondary, or forwarding) 

e Domains to be served 

e Location from which the BIND server gets initial information for lookups 
You can configure the BIND server as follows: 

e For one or more Internet domains 

e As one kind of BIND server (primary, secondary, or forwarding) 

e As multiple kinds of BIND servers 

e On TCP/IP clusters for cluster load balancing 


This command does not create a BIND 8.1 configuration. If you want to take 
full advantage of the new features available with the BIND 8.1 implementation, 
you should set up your BIND environment by editing the TCPIP$BIND.CONF 
configuration file. Refer to the HP TCP/IP Services for OpenVMS Management 
manual for detailed instructions. 


If you choose to configure your BIND environment with the SET 
CONFIGURATION BIND command, you must enter the command 
CONVERT/CONFIGURATION BIND before running BIND. 


Related commands: SHOW CONFIGURATION BIND, 
CONVERT /CONFIGURATION BIND 


SET CONFIGURATION [NOJBIND  [ /CACHE=options } 
[ [NO]JCLUSTER=names | 
[ /FORWARDERS=options ] 
[ /PRIMARY=options | 
[ /SECONDARY=options ] 


Requires SYSPRV or BYPASS privilege. 


/CACHE=([NO]DOMAIN:do,[NO]FILE: file) 
Optional. Default: None. 


Specifies the cache server for the specified domain. Do not use with 
/FORWARDERS. Use with /PRIMARY and /SECONDARY. 


The cache tells the primary or secondary server how to use hints to find the file. 
These hints let a server find a root name server. With this ability, the server 
can answer requests even if it does not have the information. You can use the 
following options: 


e DOMAIN keys to a particular record within a type. 


Descriptions 


SET CONFIGURATION BIND 


NODOMAIN deletes the entry. 
e FILE specifies the name of the hints file. 
If you use /CACHE with no options: 
e DOMAIN defaults to "." ("root"). 
e FILE defaults to NAMED.CA. 
/CLUSTER=name 


/NOCLUSTER=name 
Required to configure cluster load balancing. 


Identifies the name of a TCP/IP cluster as the first step to setting up cluster load 
balancing. 


For information about the remaining procedure, refer to the HP TCP/IP Services 
for OpenVMS Management manual. 


/NOCLUSTER=name deletes the specified name as a cluster load-balancing host. 
/FORWARDERS=([NO]HOST: hos?) 

Optional. 

Specifies the forwarding server. 

NOHOST deletes hosts. 


/PRIMARY=([NO]DOMAIN:do,[NO]FILE: file) 
Optional. Default: None. 


Specifies the primary server for the specified zone. Multiple primary servers are 
allowed if each is associated with a different domain. 


e DOMAIN keys to a particular domain. 
NODOMAIN deletes the entry. 
e FILE specifies the domain to be served. 


If you do not specify a file, the default file name is created from the value that 
you supply with the DOMAIN option. 


NOFILE specifies that no file is created. 
/SECONDARY=([NO]DOMAIN:do,[NO]FILE: file,[NO]HOST: host) 
Optional. Default: None. 


Specifies the secondary server for the specified zone. Multiple secondary servers 
are allowed if each is associated with a different domain. 


e DOMAIN keys to a particular record within a type. 
NODOMAIN deletes the entry. 
e FILE specifies the name of the boot file. 


If you do not specify a file, the default file name is created from the value that 
you supply with the DOMAIN option. 


NOFILE specifies that no file is created. 


e HOST is a list of hosts from which the secondary server copies the database 
file. 


NOHOST deletes hosts from the host list. 
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Examples 


TCPIP> SET CONFIGURATION BIND - 
_TCPIP> /PRIMARY= (DOMAIN: RHEA.LAB.UBIRD.EDU) 


Configures the host as the primary server for domain 
RHEA.LAB.UBIRD.EDU. 


TCPIP> SET CONFIGURATION BIND - 
_TCPIP> /SECONDARY=(DOMAIN: JACANA.LAB.UBIRD.EDU) - 
_TCPIP> /SECONDARY=( FILE: JACANA.DB,HOST=MARSHY ) 


Configures the host as a secondary server for domain 
JACANA.LAB.UBIRD.EDU and names the boot file JACANA.DB. 


Omitting the file name would default to file JACANA_LAB_UBIRD_EDU.DB. 


TCPIP> SET CONFIGURATION BIND - 
_TCPIP> /SECONDARY= (DOMAIN: 0.192.IN-ADDR.ARPA, HOST: WEBBED ) 


Configures the host as a secondary server for the reverse lookup domain for 
addresses that have the form 192.0.*.*. 


The boot file name defaults to 0_192_ IN-ADDR_ARPA.DB and the host copies 
this file from the host WEBBED. 
TCPIP> SET CONFIGURATION BIND /CACHE 


Points the server to the cache file (NAMED.CA), which contains hints about 
the root name servers. 


2-92 Command Descriptions 


SET CONFIGURATION COMMUNICATION 


SET CONFIGURATION COMMUNICATION 


Format 


Restrictions 


Qualifiers 


Enters information into the configuration database to start the IP, TCP, UDP, and 
INET_ACP software when the system starts up. 


When TCP/IP Services starts up, this configuration overrides the default settings. 


Related commands: SHOW CONFIGURATION COMMUNICATION, 
SET COMMUNICATION 


SET CONFIGURATION COMMUNICATION = [ /ACCEPT=options | 
[ /DOMAIN=domain | 
[ /LOCAL_HOST=host ] 
[ /PROXIES=n ] 
[ /REJECT=options ] 


Requires OPER privilege. 


/ACCEPT { =[NOJHOSTS=(hosis) | =|[NO]JNETWORKS=(networks) } 
Optional. Default: All hosts and all networks. 


Accepts communication from the hosts and networks specified. 
Do not specify the same hosts or networks for both /ACCEPT and /REJECT. 


To delete an /ACCEPT entry, specify it again using the NOHOSTS or 
NONETWORKS option. 


Specify one of the following: 
e [NO]HOSTS=hosts 
Hosts that can access TCP/IP Services. Maximum is 32. For example: 
/ACCEPT=HOSTS=(host1_name,host2_name,host3_address) 
e [NO]NETWORKS=networks 
Networks that can access TCP/IP Services. Maximum is 16. 
The syntax is: 
NETWORKS=(net1/:net1mask/,net2/:net2maskI....) 


For each network, specify: network:[network_mask]. The network mask is 
optional. (Default: class number of your network. For example, the default 
for 11.200.0.0. is 255.0.0.0.). For example: 


/ACCEPT=NETWORKS=(net1_name,net2_addr,net3_addr:net3_mask) 


/DOMAIN=domain 
Optional. 


Specifies your system’s local domain. This qualifier requires either SYSPRV or 
BYPASS privilege. 


/LOCAL_HOST=host 
Optional. 
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Defines the following logical names for the local host: 
e TCPIP$INET _HOST=host-name 


This logical is always set with the primary host name, even if the alias name 
was specified as host. 


e TCPIP$INET_HOSTADDR=host-IP-address 


If the local host has multiple IP addresses, this logical name is set with a 
name for each address, called TCPIP$INET_HOSTADDRn, where n is a 
number starting at 2. 


This qualifier requires either SYSPRV or BYPASS privilege. 


/PROXIES=n 
Optional. Default: Number of communication proxies plus 10, with a minimum 
of 20. 


Specifies the maximum size of the proxy cache. If you plan to add entries to the 
proxy database after you start the TCP/IP Services software, set /PROXIES to a 
value higher than the default. 


You cannot change this value if the TCP/IP Services software is running. 


/REJECT { =[NOJHOSTS=(hosts) | =[NO]JNETWORKS=(networks) | 
=[NO]MESSAGE=(message) } 
Optional. Default: No rejections. 


Specifies the hosts or networks that cannot access the TCP/IP Services software, 
including the rejection message that TCP/IP might return. 


(For remote login, remote shell, and remote executive, the rejection message is 
preceded by a byte with a value of 1 and terminated by a byte with a value of 0.) 


Do not specify the same hosts or networks for both /ACCEPT and /REJECT. 


To delete a /REJECT entry, specify it again using the NOHOSTS or 
NONETWORKS option. 


Specify one of the following: 


e [NO]JHOSTS=Aosts to list hosts that cannot access TCP/IP Services. 
Maximum is 32. The syntax is: 


/REJECT=HOSTS=(host1_name,host2_name, host3_address) 


e [NO]JNETWORKS=networks to list networks that cannot access TCP/IP 
Services Maximum is 16. The syntax is: 


NETWORKS=(net1/:net1mask/],net2/:net2mask/,... ) 


For each network, specify network:network_mask. The network mask is 
optional. Default: Class number of your network. For example, the default 
for 11.200.0.0. is 255.0.0.0. The syntax is: 


/REJECT=NETWORKS=(net1_name,net2_address ,net3_addr:net3_mask) 


Examples 


1. TCPIP> SET CONFIGURATION COMMUNICATION - 
_TCPIP> /REJECT=NETWORK=(16.30.0.0:255.255.0.0,16.40.0.0:255.255.0.0) 


In the configuration database, sets all the services to be inaccessible to the 
two specified networks. 
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SET CONFIGURATION ENABLE SERVICE 


Format 


Parameters 


Qualifiers 


Modifies service-related information in the permanent configuration database 
that enables (or disables) services for startup. Allows you to specify that the 
service be enabled or disabled for startup on the current node only or on all nodes 
in the cluster. To specify clusterwide enabling or disabling of services, use the 
/COMMON qualifier. 


SET CONFIGURATION ENABLE SERVICE adds an entry for a service to the 
list of enabled services in the configuration database. 


SET CONFIGURATION ENABLE NOSERVICE removes an entry for a service 
from the list of enabled services in the configuration database. 


Related commands: SHOW CONFIGURATION ENABLE SERVICE, ENABLE 
SERVICE 


SET CONFIGURATION ENABLE [NOJSERVICE _ service 
[ COMMON ] 
[ [NO]CONFIRM | 


service 
Required. 


Specifies the service to add or delete from the configuration database. 


/COMMON 
Optional. Default (when /COMMON is not specified): node-specific enabling or 
disabling of services. 


Modifies service-related information in the configuration database for the 
clusterwide enabling or disabling of services. 


/CONFIRM 
/NOCONFIRM 
Optional. Default: /CONFIRM if you use wildcards; otherwise, /NOCONFIRM. 


Use only with SET CONFIGURATION ENABLE NOSERVICE. Controls whether 
the software requests you to confirm before it deletes an entry. With /CONFIRM 
enabled, the software requests confirmation. At the CONFIRM: prompt, enter 
one of the following: 


e Y to delete the entry 
e N to retain the entry 


The /NOCONFIRM qualifier eliminates all user confirmation when deleting 
service entries. 
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Examples 


1. TCPIP> SET CONFIGURATION ENABLE SERVICE TELNET 
In the configuration database, enables the TELNET service for startup on 
this node. 

2. TCPIP> SET CONFIGURATION ENABLE SERVICE FTP /COMMON 
In the configuration database, enables the FTP service for startup on every 


node in the cluster. 


3. TCPIP> SET CONFIGURATION ENABLE NOSERVICE * 
Enable service TELNET 
Remove? [N]: Y 


In the configuration database, disables any service enabled for startup on this 
node, if confirmed by the user. 
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SET CONFIGURATION INTERFACE 


Format 


Restrictions 


Parameters 


Enters information into the configuration database, which defines one of the 
following when TCP/IP Services starts up: 


e An Internet interface (hardware connection to the network) 
e A serial line Internet interface (a form of hardware connection to the network) 


e A pseudointerface (a data structure that extends subnet routing so that, on 
the same physical network, an interface acts as a gateway between multiple 
subnets) 


Related commands: SHOW INTERFACE, SET INTERFACE 
Applies to: Routing 


SET CONFIGURATION [NOJINTERFACE _ interface 
[/[NOJARP ] 
[/[NOJAUTO_START ] 
[/BROADCAST_MASK=/P_adaress | 
[/C_BROADCAST_MASK=!/P_address] 
[/C_NETWORK=/P_address | 
[/[NO]JCLUSTER=host ] 
[/COMPRESS=options | 
[/DESTINATION=/P_adaress | 
[/[NO|DHCP } 
[/FLOWCONTROL ] 
[/HOST=host ] 
[/[NO]LOOPBACK |] 
[/NETWORK_MASK=IP_address ] 
[/[NO]PRIMARY ] 
[/SERIAL_DEVICE=device | 


This command requires: 

e OPER privilege 

e Read access to the hosts database 

e Read access to the networks database 

e Read, write, and delete access to the routes database 


Every host on the same network must have the same network mask. 


interface 
Required. 


Specifies an interface name for the communication controller, such as RF1, RT1, 
ZEO, XEO, SLO, SL1, SL2, PPO, PP1, PP2. Refer to the chapter on configuring 
network interfaces in the HP TCP/IP Services for OpenVMS Management manual 
for more information. 
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Qualifiers 


/ARP 
/NOARP 
Optional. Default: /ARP. 


Enables IP address-to-hardware address (Ethernet or FDDI) mapping. 


/ARP is valid when you create an interface but not when you modify an existing 
interface. 


/AUTO_START 
/NOAUTO_START 
Optional. Default: /AUTO_START. 


Valid for a SLIP or PPP interface. Automatically creates the interface when 
TCP/IP Services starts. 


/BROADCAST_MASK=!/P_address 
Optional. 


Sets the Internet interface to receive all broadcast messages. 
TCP/IP Services calculates the default by the following methods: 
e Using the network number 


e Setting all bits in the host number field to 1 


/C_BROADCAST_MASK=!P_address 
Optional. 


Sets the cluster broadcast mask to receive all broadcast messages. 
The software calculates the default by the following methods: 
e Using the network number 


e Setting all bits in the host number field to 1 


/C_NETWORK=!/P_address 
Optional. 


Sets the network mask of the cluster network. This mask is specific to the cluster 
host network. 


The software calculates the default by using the following methods: 
e Setting the bits representing the network fields to 1 
e Setting the bits representing the host field to 0 


/CLUSTER=host 
/NOCLUSTER 
Optional. Default: None. 


Specifies the cluster host name (alias host identifier). 
Before using this qualifier, first define the same name in the hosts database. 


/CLUSTER=Aost associates the alias host identifier with each interface in a 
cluster. 
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/NOCLUSTER disables Internet cluster processing on the specified interface. 


Caution 


When you specify /NOCLUSTER, active communication is aborted for 
applications bound to the cluster alias name. 


/COMPRESS= {ON | OFF | AUTOMATIC} 
Optional. Defaults: For PPP interface, /COMPRESS=ON; for SLIP interface, 
/COMPRESS=OFF. 


Valid for SLIP and PPP interfaces. 


Enables or disables TCP header compression. 


/COMPRESS=AUTOMATIC turns off compression unless the remote end begins 
to use it. 


/DESTINATION=/P_address 
Optional. 


Valid for a PPP interface. 


Used on the local host to provide dialup access to remote systems. The value 
specified is the IP address to be given to remote clients for use while the PPP 
connection is active. If using /DESTINATION, you must provide the address of 
the local host by using the /HOST qualifier. 


/DHCP 
/NODHCP 
Optional. 


Designates the interface as a DHCP-controlled interface in the permanent 
database. 


/FLOWCONTROL 
Optional. Default: No flow control. 


Valid for a SLIP interface. Enables the handling of XON and XOFF characters 
to interoperate properly with modems that are configured to interpret these 
characters locally. 


Specify /FLOWCONTROL only if the host at the other end of the line is running 
TCP/IP Services. 


/HOST=host 
Required when first setting the interface; optional if the interface is already 
defined. Always required for a SLIP interface. Optional for a PPP interface 


unless you are setting up the local host as a dialup provider by using the 
/DESTINATION qualifier. 


Local host name or IP address using the interface. If not specified for a PPP 
interface, PPP obtains the correct address from the remote host. 


If your host is multihomed, specify an address. 
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Examples 


/LOOPBACK 
/NOLOOPBACK 
Optional. Default: /NOLOOPBACK. 


Sets loopback mode. 


/NETWORK_MASK=!P_address 
Required if you use subnets. 


The part of the host field of the IP address identified as the subnet. 
The software calculates the default by the following methods: 

e Setting the bits representing the network fields to 1 

e Setting the bits representing the host field to 0 


An IP address consists of a network number and a host number. You can also 
divide the host field into a site-specific subnetwork and host field. 


/PRIMARY 
/NOPRIMARY 
Optional. 


For DHCP-controlled interfaces, designates the interface from which system-wide 
configuration options (such as the IP address of the BIND server) are used. 


/SERIAL_DEVICE=device 
Required for SLIP and PPP interfaces; otherwise, not used. 


Identifies the OpenVMS terminal device used as a serial device. Specify an 
arbitrary terminal device name. (Unlike Ethernet, FDDI, and Token Ring 
interface names, a serial interface name is not related to the OpenVMS device 
name.) 


1. TCPIP> SET CONFIGURATION INTERFACE SL5 /HOST=LARK - 
TCPIP> /NETWORK_MASK=255.255.255.0 /SERIAL DEVICE=TTA3: - 
TCPIP> /COMPRESS=ON /FLOWCONTROL 


Configures SLIP interface SL5, using the local IP address assigned to host 
LARK, with a subnet mask of 255.255.255.0. 


The interface uses the terminal device TTA3:. 
The /COMPRESS qualifier enables TCP header compression (CSLIP). 


The /FLOWCONTROL qualifier enables special handling of XON and XOFF 
characters for proper interoperation with modems that are configured to 
interpret these characters locally. 


2. TCPIP> SET CONFIGURATION INTERFACE FFO /HOST=KESTREL - 
TCPIP> /NETWORK MASK=255.255.0.0 - 


“TCPIP> /BROADCAST_MASK=128.30.0.0 /ARP 


For new interface FF0 on host KESTREL, sets the network mask to 
255.255.0.0, sets the broadcast mask to 128.30.0.0, enables ARP, and activates 
the interface. 
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TCPIP> SET CONFIGURATION INTERFACE PPO /SERIAL_DEVICE=TTAO i 
_TCPIP> /HOST=10.10.1.2 /DESTINATION=10.10.1.3 


Configures the interface as a PPP serial device. This command specifies 
that the local host is a dialup provider. The address specified with the 
/DESTINATION qualifier (10.10.1.3) is the address assigned to the client 
system requesting an address. 


Refer to the HP TCP/IP Services for OpenVMS Management manual for more 
information about setting up interfaces for SLIP and PPP communication. 


Command Descriptions 2-101 


SET CONFIGURATION MAP 


SET CONFIGURATION MAP 


Adds information to the configuration database that maps (logically links) one of 
the following to the NFS server: 


e OpenVMS disk — Requires one execution of SET CONFIGURATION MAP to 
map the disk to a UNIX path name (logical file system). 


e Container file system — Requires two executions of SET CONFIGURATION 
MAP. The first maps the disk, and the second maps the file system. 


Mapping creates a logical file system, also called an NFS file system. 


When the NFS server starts up, it issues a GENERATE MAP command, which 
creates the mappings for disks and container file systems; these mappings are 
viewable with the SHOW MAP command. 


Related commands: ADD EXPORT, SHOW EXPORT, REMOVE EXPORT, 
MAP, UNMAP, SET CONFIGURATION NOMAP, SHOW MAP, SHOW 
CONFIGURATION MAP 

Format 


SET CONFIGURATION MAP "file system name" logical_file_system 


Restrictions 
Requires SYSPRV and BYPASS privileges. 


Parameters 


"file system name" 
Required. 


Specifies the name for the file system or disk. When mapping a disk, the "/path" 
can be only one level from the root. This parameter specifies the name by which 
users access the file system. 


logical_file_system 

Required. 

Specifies the file system to make known to the NFS server. 

To map an OpenVMS file system, specify its disk as follows: 

$ SET CONFIGURATION MAP "/disk" disk: 

To map a container file system, specify the disk and the directory name as follows: 
TCPIP> SET CONFIGURATION MAP "/container_name" - 


_TCPIP> disk:[vms.directory.name] 


Examples 


1. TCPIP> SET CONFIGURATION MAP "/usr" CANARYSDUA2: 


Maps local disk CANARY$DUA2: to /usr. This disk can be exported to users 
on remote NFS clients as /usr. 
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TCPIP> SET CONFIGURATION MAP "/remote" VERDINSDUA3: - 
_TCPIP> SET CONFIGURATION MAP "/flyers" VERDINSDUA3: [UNIX BIRD FILES] 


Maps [UNIX_BIRD_FILES], a container file system on disk VERDIN$DUAS:, 
to /flyers. This file system can be exported to NFS server users as /flyers. 
(The first MAP command maps the underlying OpenVMS file system.) 
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SET CONFIGURATION NAME_SERVICE 


Format 


Qualifiers 


When TCP/IP Services starts up, configures the BIND resolver and designates a 
BIND server. All settings are systemwide. 


Related commands: SET NAME_SERVICE, 
SHOW CONFIGURATION NAME_SERVICE 


SET CONFIG [NOJNAME_SERVICE _ [ /[NO]SERVER=host] 
[ [NO]DOMAIN=domain | 
[ INO]PATH=domain ] 
[ /RETRY=number of retries ] 
[ /TIMEOUT=seconds ] 
[ /TRANSPORT=protocol | 


/CLUSTER=dev:/directory] 
Optional. 


Specifies the common BIND directory. By default, the clusterwide common 
database common-disk:[TCPIP$BIND_common] is used. This qualifier reloads the 
BIND database on every master BIND server running the OpenVMS cluster. 


/DOMAIN=domain 
/NODOMAIN 
Optional. Default: The local domain. 


Defines the default domain. 
/NODOMAIN deletes the definition of the domain. 


/PATH=domain 
/NOPATH=domain 
Optional. SYSNAM privilege is required for this command. 


Defines the BIND resolver domain search list. The /NOPATH qualifier removes 
domains from the list. 


To specify multiple domains, list them by search preference. The resolver starts 
with the first domain on the list, and continues to search each domain until the 
name is found (or until all domains have been exhausted and the lookup fails). 


If you define a domain list and then issue another SET CONFIGURATION 
NAME_SERVICE /PATH command, TCP/IP Services appends the new domains to 
the end of the list. 


If a search list is not defined, the default behavior of the BIND resolver is to do a 
lookup on the name as you typed it. If that lookup fails, then the default domain 
is appended and the lookup is attempted again. 


/RETRY=number of retries 
Optional. Default: Four retries. 


Number of times that the BIND resolver attempts to contact a BIND server if 
previous tries failed. 
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SET CONFIGURATION NAME_SERVICE 


/SERVER=host 
/NOSERVER=host 
Optional. 


Host name or address of the BIND server or servers that the BIND resolver will 
query. 


To specify multiple hosts, list them by request preference. The resolver sends the 
first lookup request to the first host on the list. 


/NOSERVER removes hosts from the list. 


If you define a server list and then issue another 
SET CONFIGURATION NAME_SERVICE /SERVER command, TCP/IP Services 
appends the new servers to the end of the list. 


/TIMEOUT=seconds 
Optional. Default: 4 seconds. 


Timeout interval for the BIND resolver’s requests to a BIND server. Represents 
the length of time to wait for a reply after each retry attempt. 


The total timeout period will be: 


timeout_value * retry_value * number_servers 


/TRANSPORT=protocol 
Optional. Default: UDP. 


Protocol used for communicating with a BIND server. Specify one: 
e UDP 
e TCP 


1. TCPIP> SET CONFIGURATION NAME SERVICE /SERVER= (PARROT, SORA, JACANA) 


When TCP/IP Services starts, defines hosts PARROT, SORA, and JACANA as 
BIND servers. 


2. TCPIP> SET CONFIGURATION NAME SERVICE /SERVER=OSPREY - 
_TCPIP> /PATH=(abc.dec.com, xyz.dec.com) 


When TCP/IP Services starts, defines host OSPREY as the BIND server. The 
BIND resolver searches the abc.dec.com domain first, and then searches the 
xyz.dec.com domain. 
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SET CONFIGURATION NOMAP 


Removes map records from the configuration database that were previously added 
with SET CONFIGURATION MAP. When the NFS server starts up, it issues a 
GENERATE MAP command that creates the mappings for disks and container 
file systems. 


Related commands: SET CONFIGURATION MAP, 
SHOW CONFIGURATION MAP, ADD EXPORT, SHOW EXPORT, REMOVE 
EXPORT, MAP, UNMAP, SHOW MAP 


Format 
SET CONFIGURATION NOMAP “/path/name"  [ /[NO|JCONFIRM ] 


Restrictions 
Requires SYSPRV and BYPASS privilege. 


Parameters 


"/path/name" 
Required. 


UNIX name of the file system to unmap. 


You can use wildcards. 


Qualifiers 


/CONFIRM 
/NOCONFIRM 
Optional. Default: /CONFIRM if you use a wildcard. 


With /CONFIRM enabled, requests confirmation before unmapping each file 
system. If you specify the /NOCONFIRM qualifier, the operation is performed 
without asking you to confirm the request. 


Examples 


1. TCPIP> SET CONFIGURATION NOMAP "/disk host" 


Unmaps the NFS file system /remote, making it unavailable to client users 
when TCP/IP Services starts. 
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SET CONFIGURATION PROTOCOL 


Enters information into the configuration database that sets the parameters for 
ICMP, IP, TCP, and UDP when TCP/IP Services starts up. 


Related commands: SET PROTOCOL, SHOW CONFIGURATION PROTOCOL 


Format 
SET CONFIGURATION PROTOCOL ICMP [ /NOJREDIRECT ] 


SET CONFIGURATION PROTOCOL IP [ /[INOJFORWARD |] 
[ /REASSEMBLY_TIMER=seconds ] 


SET CONFIGURATION PROTOCOL TCP [ [NOJMTU_SEGMENT_SIZE ] 
[ /[NO]DELAY_ACK ] 
[ /DROP_COUNT=n ] 
[| /PROBE_TIMER=seconds ] 
[ /QUOTA=[ SEND=bytes, RECEIVE=bytes ] | 
[ /[NO]WINDOW_SCALE ] 


SET CONFIGURATION PROTOCOL UDP [ /[NO]JBROADCAST ] 
[ [NO]JFORWARD | 
[ /QUOTA=options | 
Restrictions 
Requires OPER privilege. 


Parameters 


{ICMP | IP | TCP | UDP} 
Required. 


Specifies the protocol software to configure. 


ICMP Qualifiers 


/REDIRECT 
/NOREDIRECT 
Optional. Default: /NOREDIRECT. 


Sends ICMP_REDIRECT messages. 


IP Qualifiers 


/FORWARD 
/NOFORWARD 
Optional. Default: /NOFORWARD. 


Forwards IP messages to other hosts. 


/REASSEMBLY_TIMER=n 
Optional. Default: 7 seconds. Valid range: 1 to 126. 


Sets the maximum time for trying to reassemble a received datagram. 
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TCP Qualifiers 


/MTU_SEGMENT_SIZE 
/NOMTU_SEGMENT_SIZE 
Optional. Default: /NOMTU_SEGMENT_SIZE. 


If a connection is more than one hop away, sets the segment size. Specify one of 
the following: 


/MTU_SEGMENT_SIZE Sets the segment size as close as possible to the 
maximum transfer unit (MTU) size. 


/NOMTU_SEGMENT_SIZE Sets the segment size as close as possible to the 
standard 512 bytes. 


/DELAY_ACK 
/NODELAY_ACK 
Optional. Default: /DELAY_ACK. 


Enables or disables a delay before sending acknowledgments: 


/DELAY_ACK ACKs are generated with a delay. 
/NODELAY_ACK ACKs are generated without any delay. 
/DROP_COUNT=n 

Optional. 

Number of idle probes that can go unsatisfied before the software declares a TCP 
connection dead and closes it. 

/PROBE_TIMER=n 

Optional. Default: 75 seconds. 


Number of seconds between probes for idle TCP connections (when the 
SO_KEEPALIVE option is set). If the remote system fails to respond, the 
connection is removed. Also, when initiating a TCP connection request, indicates 
the maximum number of seconds that the software waits for a response from the 
remote system before the request times out. 


/QUOTA=[SEND=bytes, RECEIVE=bytes] 
Optional. 


Specifies the queue size (in bytes) for messages. 

The options for setting TCP message queue size are: 

e RECEIVE:n — Receive queue size. Default: 4096 bytes. 
e SEND:n — Send queue size. Default: 4096 bytes. 


/WINDOW_SCALE 
/NOWINDOW_SCALE 
Optional. 


Turns TCP window scaling on and off. Default is on. 


Scaling allows windows larger than 64 KB to be represented in the normal 16-bit 
TCP window field. Large windows allow improved throughput. Turning this 
option off may help troubleshoot communication problems with another TCP/IP 
implementation. 
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UDP Qualifiers 


Examples 


/BROADCAST 
/NOBROADCAST 
Optional. Default: /NOBROADCAST. 


Enables privilege checking for broadcast messages. 
e /BROADCAST — Nonprivileged users can send broadcast messages. 


e /NOBROADCAST — To send broadcast messages, users need a privileged 
UIC or SYSPRV, BYPASS, or OPER privilege. 


Sun RPC applications use broadcast messages and need privilege checking 
disabled. 


/FORWARD 
/NOFORWARD 
Optional. Default: /NOFORWARD. 


Forwards IP messages. 


/QUOTA=options 
Optional. 


Specifies the queue size (in bytes) for messages. 

The options for setting UDP message queue size are: 

e RECEIVE:n — Receive queue size. Default: 9000 bytes. 
e SEND:n — Send queue size. Default: 9000 bytes. 


1. TCPIP> SET CONFIGURATION PROTOCOL IP /FORWARD 


Sets IP to forward messages to other hosts, including other Internet cluster 
nodes. 


2. TCPIP> SET CONFIGURATION PROTOCOL TCP /PROBE_TIMER=50 


Sets the TCP protocol probe timer parameter to 50 seconds. 
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SET CONFIGURATION SMTP 


Format 


Restrictions 


Qualifiers 


Modifies the SMTP configuration in the configuration database. 
SET CONFIGURATION NOSMTP with no qualifiers deletes all SMTP records. 
Related commands: SHOW CONFIGURATION SMTP 


SET CONFIGURATION [NOJSMTP_ [ /ADDRESS_RETRIES=n ] 
[ /GATEWAY=option=host ] 
[ /HOP_COUNT_MAXIMUM=n J 
[ INTERVAL=options | 
[ [NOJLOG=[file] ] 
[ /OPTIONS=options ] 
[ /QUEUES=n ] 
[ /RECEIVE_TIMEOUT=minutes ] 
[ /SEND_TIMEOUT=minutes ] 
[ /SUBSTITUTE_DOMAIN=[NO]NAME=tully-qualified-name ] 
[ INOJZONE[=domain] | 


For clusters, issue this command only on the nodes where the SMTP queues 
reside — that is, on nodes that are not using clusterwide queues and are not 
managing clusterwide queues for other nodes. 


Requires SYSPRV or BYPASS privilege. 


/ADDRESS_RETRIES=n 
Optional. Default: 16. 


Maximum number of different addresses to which SMTP will send as it tries to 
deliver mail. Beyond this number of attempts, the message is undeliverable. 


A message is also undeliverable if SMTP fails to deliver after it attempts all the 
possible addresses from an MX lookup. 


/GATEWAY=option=host 
Optional. Default: None. 


An alternate route through which SMTP sends mail if delivery fails. 
e [NOJALTERNATE=host 
— Alternate host or domain to which delivery is attempted. 


— Used by ZONE, if a zone is defined, as the last chance for delivery (see 
the /ZONE qualifier). 


— NOALTERNATE deletes an existing alternate destination. 
e [NO]GENERAL_PURPOSE=hAost 
— Gateway to handle non-SMTP mail, for example, UUCP addresses. 
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—- NOGENERAL_ PURPOSE deletes the specified destination for protocols 
other than SMTP. 


/HOP_COUNT_MAXIMUM=n 
Optional. Default: 16. 


Maximum number of relays (hops) between routers until SMTP considers the 
mail undeliverable. 


AINTERVAL={ INITIAL="OpenVMS_delta_time" | RETRY="OpenVMS_delta_time" 
| MAXIMUM="OpenVMS_delta_time" } 

Optional. Defaults: INITIAL=30 minutes, RETRY=60 minutes, MAXIMUM=3 
days. 


Time intervals related to repeated attempts before delivery fails. Specify the 
value within quotation marks as follows: "dddd hh:mm:ss:cc." For example: 


dddd = days (0-9999) 


h = hours (0-24) 
m = minutes 
s = seconds 
cc = milliseconds 


You can modify the following options: 


e INITIAL="OpenVMS_delta_time" is the amount of time that SMTP waits 
before making a second attempt to deliver. 


e RETRY="OpenVMS_delta_time" is the time SMTP waits between retries, 
starting with the second attempt. (Recommended time: twice the initial 
interval.) 


e MAXIMUM="OpenVMS_delta_time" is the maximum elapsed time that SMTP 
retries delivery. 


/LOG=[file] 

/NOLOG=[file] 

Optional. Default: SYS$SPECIFIC:[TCPIP_SMTP]TCPIP$SMTP_ 
LOGFILE.LOG. 


File to which SMTP queue activity is logged. 


/OPTIONS=options 
Optional. Defaults: NOEIGHT_BIT, HEADERS, NORELAY. 


The following SMTP options are available: 
e [NO]EIGHT_BIT 


All characters must have the eighth bit clear. Allows the transmission of 8-bit 
characters. 


e Header control. Specify one of the following: 


HEADERS Headers are printed at bottom of messages. 
NOHEADERS Headers are omitted. 
TOP_HEADERS Headers are printed at top of messages. 


NOTOP_HEADERS _ Resets TOP_HEADERS to the default. 


Command Descriptions 2-111 


SET CONFIGURATION SMTP 


e [NO]RELAY 


Relays mail to other hosts by functioning as an end node. 


/QUEUES=n 
Optional. Default: 1. 


Number of execution queues for the specified nodes. 


Use this qualifier only on nodes that own the SMTP queues — that is, nodes not 
using clusterwide SMTP queues or managing SMTP clusterwide queues for other 
nodes. 


/RECEIVE_TIMEOUT=minutes 
Optional. Default: 5 minutes. 


Maximum time between socket receipts of a message for a particular dialog. 


If a message is not received within this interval, the connection is broken and the 
mail control file is deleted. 


/SEND_TIMEOUT=minutes 
Optional. Defaults: 


DATA — 3 minutes 

INITIAL — 5 minutes 

MAIL — 5 minutes 

RECEIPT — 5 minutes 
TERMINATION — 10 minutes 


Maximum time between remote host acknowledgments of a particular SMTP 
command. 


If an acknowledgment is not received within the specified time, it is assumed 
that there are communication problems with the remote host. If the next delivery 
attempt takes place before the mail’s delivery date, the mail is rescheduled for 
later delivery. 


/SUBSTITUTE_DOMAIN=[NO]NAME=tully-qualified-domain 
Optional. 


By default, the From: and Return-Path fields display the sender’s name and 
fully qualified domain. NONAME causes the sender’s domain name to be 
omitted from the Return-Path field. If you specify a fully qualified domain name 
(/SUBSTITUTE_DOMAIN=NAME=/ully-qualified-domain), that specified domain 
name is displayed as the sender’s domain name. 


For example, suppose you specify the fully qualified domain name eagle 
for the sender’s return path (SUBSTITUTE_DOMAIN=NAME=eagle). 
When user magpie on host condor. hawk.eagle.org sends mail to daw on 
another host, user daw sees the return path as magpie@eagle rather than 
magpie@condor.hawk.eagle.org. 


This is what daw sees: 


#707 18-NOV-2002 14:02:02.71 MAIL 
From: SMTP%"magpie@eagle" 
To: SMTP$"daw@crow.ravin.rook.org" 


Subj: Big sale today! 
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SET CONFIGURATION SMTP 


Note 


For changes made with the /SUBSTITUTE_DOMAIN qualifier to take 
effect, you must stop and restart SMTP. For more information about 
stopping and starting SMTP, refer to the HP TCP/IP Services for 
OpenVMS Management manual. 


/ZONE[=domain] 
/NOZONE[=domain] 
Optional. Default: /NOZONE (no gateway searching). 


Domain for your environment (probably a superset of your local domain). 
Mail sent to another network must be sent to this gateway. 
With no value, /ZONE defaults to one level higher than your local domain. 


For example, if your local domain is a.b.com, the default value of /ZONE is 
b.com because TCP/IP Services has been started; this assumes that the domain is 
known. 


Mail for delivery outside of your zone is sent to its destination by the alternate 
gateway (see the /GATEWAY qualifier). 


1. TCPIP> SET CONFIGURATION SMTP /INTERVAL=(INIT="0 00:10:00.00") 


The system waits 10 minutes before making its first attempt to deliver the 
message. 


2. TCPIP> SET CONFIGURATION SMTP /INTERVAL=(RETRY="0 00:20:00.00") 


Specifies the wait time between retries. 


3. TCPIP> SET CONFIGURATION SMTP /INTERVAL=(MAX="3 00:20:00.00") 


Specifies the maximum amount of time to retry before an error message is 
issued. 


4. TCPIP> SET CONFIGURATION SMTP /GATEWAY= (ALTERNATE: route_gateway) 


Specifies the alternate host or domain to which delivery is attempted if mail 
cannot be delivered to the primary destination. 


5. TCPIP> SET CONFIGURATION SMTP /GATEWAY=(GENERAL:uucp_gateway) 


Specifies a general-purpose gateway to handle non-SMTP mail. 


6. TCPIP> SET CONFIGURATION SMTP /ZONE=rsch.opt.com 


Specifies that rsch is a domain that can be used to divert messages to nodes 
outside the local domain. 


Command Descriptions 2-113 


SET CONFIGURATION SNMP 


SET CONFIGURATION SNMP 


Format 


Restrictions 


Qualifiers 


Configures SNMP on an individual host. 
SET CONFIGURATION NOSNMP does not require any qualifiers. 


After making changes to the SNMP configuration, shut down and restart the 
master agent and any subagents. Issue the following commands: 


$ @SYSSSTARTUP:TCPIPS$SNMP_ SHUTDOWN 
$ @SYSSSTARTUP:TCPIPSSNMP_STARTUP 


Related command: SHOW CONFIGURATION SNMP 


SET CONFIGURATION [NOJSNMP_ [ /[NOJADDRESS=host ] 
[ [NOJCOMMUNITY="name" | 
[ NO]CONFIRM ] 
/CONTACT=name | 
/FLAGS=options| 
/LOCATION=options | 
/TYPE=options | 


niin iment! 


Requires SYSPRV or BYPASS privilege. 


If you add a new community and do not specify the /TYPE qualifier, the value of 
/TYPE defaults to read only. 


If you add a new community and do not specify the /ADDRESS qualifier, the 
default address is 0.0.0.0. 


/ADDRESS=(/P_address) 
/NOADDRESS=(/P_address) 
Optional. Default: 0.0.0.0 


Specifies hosts that belong to a particular community. You can specify multiple 
addresses. 


This qualifier is meaningful only if you include the /COMMUNITY qualifier. A 
remote host cannot access information from this host unless its address appears 
in one or more communities of type READ or WRITE. For communities of type 
TRAP, the addresses specify the hosts that receive trap messages. For more 
information, see the /TYPE qualifier. 


If you add a new community and do not specify this qualifier, the new entry’s 
address is 0.0.0.0. 


If you use the /ADDRESS qualifier with a community that already exists, these 
addresses are added to the existing address list. 


/NOADDRESS deletes addresses from an existing list. If the deleted address is 
the only address listed for the community name, this qualifier also deletes the 
community. 
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/COMMUNITY="name" 

/NOCOMMUNITY= "name" 

Optional. Default: To enable the standard "public" community, you can run the 
TCPIP$CONFIG procedure. 


Used with the /ADDRESS qualifier. Name of the community that the SNMP 
agent recognizes. Optionally, specify a type of access and a list of host addresses. 
Enclose the name in quotation marks to preserve lowercase characters. See the 
/TYPE and /ADDRESS qualifiers for more information. 


[NO]ICOMMUNITY="name" removes a community name. 


/CONFIRM 

/NOCONFIRM 

Optional. Default: /CONFIRM with if you use a wildcard; otherwise, 
/NOCONFIRM 


When you delete communities (with the /(NOCOMMUNITY qualifier), first asks 
for your confirmation. 


If you specify the /NOCONFIRM qualifier, the operation is performed without 
asking you to confirm the request. 
/CONTACT=name 
Optional. Default: None. 
Name of the system administrator (or other contact person) of the host on which 
the SNMP agent runs. The name field has a maximum length of 235. 
/FLAGS=options 
Optional. 
The options include: 
e SETS 
Lets the master agent process SET commands from SNMP clients. 
e AUTHEN_TRAPS 
Lets the master agent send trap messages in response to unauthorized 
community strings from SNMP clients. 
/LOCATION=options 
Optional. Default: None. 


Location of the system on which the SNMP agent runs. Maximum total length is 
215 characters. 


The options include: 


e = [NO]FIRST=text 


Specifies the first part of the location. Maximum length of text is 200 
characters. 


e [NO]SECOND=text 


Specifies the last part of the location. Maximum length of text is 200 
characters. 
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If you specify two options, they are appended when sent to a client in response to 
an SNMP request for syslocation. For example, if FIRST is abe and SECOND 
is def, the value of the location is abedef with no spaces. The total number of 
characters must not exceed 215. 


/TYPE= {[NO]JREAD | [NO]TRAP | [NO]WRITE} 
Optional. Default: READ. 


Sets the type of access (to your local MIB data) to allow for a specified community. 


e Type READ allows the master agent to accept GET, GETNEXT, and 
GETBULK commands from clients (management stations). 


e Type TRAP allows the local master agent to issue traps to members of a 
specified community. Members of a trap community receive SNMP Trap- 
PDUs for significant events, including coldStart traps when the agent is 
initialized, and authenticationFailure traps when the agent receives an 
SNMP request that specifies an unauthorized community string. 


e Type WRITE allows the master agent to accept SET commands from clients 
(management stations). 


READ access is present by default when specifying TRAP or WRITE. Also, you 
can remove the read access without affecting the way the agent responds to a 
read request. For example: 


$ SET CONFIGURATION SNMP /COMMUNITY="name" /TYPE=NOREAD 


Examples 


1. TCPIP> SET CONFIGURATION SNMP /COMMUNITY="public" - 
TCPIP> /CONTACT="Sam Spade" - 
“TCPIP> /LOCATION=(FIRST="Falcon Building",SECOND="Los Angeles, 
California") 


Configures SNMP with the standard public community, taking the default 
type (READ) and address (0.0.0.0) for that community. Both contact and 
location are specified. 


The first and second parts of the location text are concatenated when 
displayed by an SNMP client. For example: 


Falcon BuildingLos Angeles, California 


If no update to the location text is done by an SNMP client, the display 
produced by SHOW CONFIGURATION SNMP is as follows: 


Location 
First: Falcon Building 
Second: Los Angeles, California 


If the text is updated by an SNMP client (for example, to change "Falcon" to 
"Falconi"), the original formatting is not preserved and the display produced 
by SHOW CONFIGURATION SNMP is as follows: 


Location 
First: Falconi BuildingLos Angeles, California 
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TCPIP> SET CONFIGURATION SNMP /COMMUNITY="rw" /TYPE=WRITE - 
_TCPIP> /ADDRESS=136.20.100.10 /FLAGS=SETS 


Configures a community with only read/write access to the host with the 
address specified. Other hosts still have read access through the public 
community. Also sets the SETS flag to enable the SNMP agents to process 
write requests from SNMP clients on host 136.20.100.10. 
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3. TCPIP> SET CONFIGURATION SNMP /NOCOMMUNITY="rw" 


Removes the rw (read/write) community (set in example 2.) 


4. TCPIP> SET CONFIGURATION SNMP /COMMUNITY="trapit" /TYPE=TRAP - 
_TCPIP> /ADDRESS=136.20.0.10 


Configures SNMP so that agents can send trap messages to the well-known 
UDP port 162 on the host identified with the address 136.20.0.10. 


5. TCPIP> SET CONFIGURATION SNMP /FLAGS=AUTHEN_TRAPS - 
_TCPIP> /COMMUNITY="trapit2" /TYPE=TRAP - 
_TCPIP> /ADDRESS=(136.20.0.12,136.20.0.15) 


Configures SNMP with the AUTHEN_TRAPS flag so that the master agent 
sends trap messages when it detects a client request containing an invalid 
community name. Also configures an additional trap community. Trap 
messages, including authentication traps, go to all three addresses specified 
in the trap communities configured in this example and in example 4. 


6. TCPIP> SET CONFIGURATION SNMP /COMMUNITY="rw2" /TYPE=WRITE - 
_TCPIP> /ADDRESS=(136.20.0.15,136.20.0.100) 


Configures community rw2, which gives read/write access to two hosts. Note 
that one address can appear for more than one community, although a given 
address cannot be specified more than once for a single community. 
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SET CONFIGURATION START ROUTING 


Format 


Qualifiers 


Examples 


Enters information into the configuration database to start dynamic routing when 
TCP/IP Services starts. 


Related commands: SHOW CONFIGURATION START ROUTING, 
START ROUTING 


SET CONFIGURATION START [NOJROUTING [ /GATED ] 
[ /LOG ] 
[ /SUPPLY[=DEFAULT] ] 


/GATED 
Optional. 


Enables the gateway routing daemon (GATED). 


If you enable dynamic GATED routing, you will be able to configure this host 
to use any combination of the following routing protocols to exchange dynamic 
routing information with other hosts on the network: 


e RIP (Routing Information Protocol), Versions 1 and 2 
e RDISC (Router Discovery Protocol) 

e OSPF (Open Shortest Path First) 

e EGP (Exterior Gateway Protocol) 

e BGP (Border Gateway Protocol), BGP-4 


e Static routes 


/LOG 
Optional. Default: No logging. 


Applies to ROUTED. Do not use with /GATED. 
Logs routing activity to 
SYS$SYSDEVICE:[TCPIP$ROUTED]TCPIP$ROUTED.LOG. 


/SUPPLY[=DEFAULT] 
Optional. Applies only to ROUTED. Do not use with /GATED. 


Broadcasts routing information to other hosts in 30-second intervals. 


If you specify /SUPPLY=DEFAULT, the local host supplies the default network 
route. 


1. TCPIP> SET CONFIGURATION START ROUTING /SUPPLY 


Starts ROUTED dynamic routing when TCP/IP Services is started. The local 
host both broadcasts and receives network routing information. 
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SET GATED 


Format 


Qualifiers 


Examples 


Configures the Gateway Routing Daemon (GATED). GATED obtains information 
from several routing protocols and selects the best routes based on that 
information. These protocols are configured in the file TCPIP${GATED.CONF. 


Related commands: START ROUTING /GATED, STOP ROUTING /GATED 


SET GATED [ /CHECK_INTERFACES ] 
[ /FILE=file | 
[ SAVE_STATE ] 
[ TOGGLE_TRACE ] 


/CHECK_INTERFACES 
Optional. 


Instructs GATED to scan the kernel interface list for changes. 

/FILE=file 

Optional. 

Specifies the name of the GATED configuration file. Use with the /SAVE_STATE 
qualifier. 

/SAVE_STATE 

Optional. 


Causes GATED to save the current state of all tasks, timers, protocols, and tables 
to the file SYS$SYSDEVICE:[TCPIP$GATED]TCPIP$GATED.DMP (default). 


Use the /FILE qualifier to specify a file name other than the default. 


/TOGGLE_TRACE 
Optional. 


Use to close the trace file. A subsequent set GATED /TOGGLE_TRACE command 
reopens the trace file. This allows the file to be copied regularly. Valid only when 
a trace file is specified in the GATED configuration file. 


1. TCPIP> SET GATED /SAVE_STATE 
This example causes GATED to save its current state to the file 
SYS$SYSDEVICE:[TC PIP$GATED]TCPIP$GATED.DMP. 

2. TCPIP> SET GATED /SAVE_STATE /FILE=STATE . DMP 


This example causes GATED to save its current state to the file named 
STATE.DMP. 
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SET HOST 


Format 


Restrictions 


Parameters 


Qualifiers 


Defines or deletes an entry in the hosts database. 
Equivalent to maintaining the /etc/hosts file on UNIX hosts. 
Related command: SHOW HOST, CONVERT/VMS HOST 


SET [NOJHOST host 
/ADDRESS=!/P_address 
[ /[NOJALIAS=alias ] 
[ /[NO]JCONFIRM ] 


Requires read, write, and delete access to the hosts database. 


host 
Required. 


Name of a host that is a source or destination of Internet communications. 


Note 


If you define a mixed-case name, also define an alias in either all 
uppercase or all lowercase characters. 


You cannot delete a host by specifying its alias. 


/ADDRESS=!/P_address 
Required SET HOST. 


Host’s IP address. 


/ALIAS=alias 
/NOALIAS=alias 
Optional. 


Add or remove an alternate name for a host. 


Do not use with SET NOHOST. 


/CONFIRM 
/NOCONFIRM 
Optional. Default: /CONFIRM if you use a wildcard. 


Used with the SET NOHOST command, prompts you to confirm the delete 
request. For example: 
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TCPIP> SET NOHOST MOA /ADDRESS=11.33.33.8 /CONFIRM 
LOCAL database 
Host address Host name 


11.33.33.8 MOA 
Remove? [N]: 


If you specify the /NOCONFIRM qualifier, the operation is performed without 
asking you to confirm the request. 


Examples 


1. TCPIP> SET HOST MOA /ADDRESS=11.33.33.8 - 
_TCPIP> /ALIAS=("moa","bigbrd","nofly") 


Sets the IP address of host MOA to 11.33.33.8 and establishes moa, bigbrd, 
and nofly as aliases for host MOA. 


2. TCPIP> SET HOST MOA /ALIAS="MOA_2" 
Establishes MOA_2 as an alias for host MOA. 


3. TCPIP> SET HOST MOA /ADDRESS = 128.33.33.9 
Establishes a second IP address for host MOA. 


4. TCPIP> SET HOST MOA /ADDRESS = 128.33.33.9 /ALIAS="MOA_3" 
Establishes MOA_3 as an alias for host MOA’s second IP address 128.33.33.9. 


5. TCPIP> SET HOST MOA /NOALIAS="MOA_2" 
Deletes MOA_2 as an alias for host MOA. 


6. TCPIP> SET NOHOST MOA /NOCONFIRM 


Deletes MOA and all of its associated aliases. 
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SET INTERFACE 


Format 


Restrictions 


Defines one of the following: 

e An Internet interface 

e A serial line IP (SLIP) or point-to-point (PPP) connection 

e A pseudointerface (a data structure that extends subnet routing) 


Before you issue SET INTERFACE, do the following to identify the name of an 
interface: 


e Issue the LIST COMMUNICATION_CONTROLLER command to find your 
system’s controller. 


e Use the first character of the associated interface name. 


Refer to the HP TCP/IP Services for OpenVMS Management manual for more 
information about specifying an interface name. 


SET NOINTERFACE deletes a record. No qualifiers are required. 


Related commands: SHOW INTERFACE, SET CONFIGURATION 
INTERFACE 


SET [NOJINTERFACE _ interface 
[ [NOJARP ] 
[ [NOJAUTO_START ] 
[ /BROADCAST_MASK=/P_address | 
[ /C_BROADCAST_MASK=/P_adaress | 
[| /C_NETWORK=IP_address ] 
[ INO|JCLUSTER=host | 
[ COMPRESS=options |] 
[ /DESTINATION=/P_adaress ] 
[ /DHCP ] 
[ /FLOWCONTROL ] 
[ /HOST=host ] 
[ [NOJLOOPBACK J] 
[ /NETWORK_MASK=!/P_adaress | 
[ /PRIMARY ] 
[ /SERIAL_DEVICE=device | 


Before you issue the SET INTERFACE command, disable the interface by using 
the SET NOINTERFACE command. 


This command requires: 

e OPER privilege 

e Read access to the hosts database 

e Read access to the networks database 

e Read, write, and delete access to the routes database 


Every host on the same network must have the same network mask. 
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Parameters 


interface 
Required. 


Specifies an interface name for the communication controller, such as RF1, RT1, 
ZEO, XEO, SLO, SL1, SL2, PPO, PP1, PP2. 
Qualifiers 


/ARP 
/NOARP 
Optional. Default: /ARP. 


Enables IP address-to-hardware address (Ethernet or FDDI) mapping. 


/ARP is valid when you create an interface but not when you modify an existing 
interface. 


/AUTO_START 
/NOAUTO_START 
Optional. Default: /AUTO_START. 


Valid for a SLIP or PPP interface. Automatically creates the interface when 
TCP/IP Services starts. 


/BROADCAST_MASK=!/P_address 
Optional. 


Sets the Internet interface to receive all broadcast messages. 
TCP/IP Services calculates the default by: 
e Using the network number from the network mask 


e Setting all bits in the host number field to 1 


/C_BROADCAST_MASK=!P_address 
Optional. 


Sets the cluster broadcast mask to receive all broadcast messages. 
The software calculates the default by: 
e Using the network number from the network mask 


e Setting all bits in the host number field to 1 


/C_NETWORK=/P_address 
Optional. 


Sets the network mask of the cluster network. This mask is specific to the cluster 
host network. 


The software calculates the default by: 
e Setting the bits representing the network fields to 1 
e Setting the bits representing the host field to 0 


/CLUSTER=host 
/NOCLUSTER 
Optional. Default: None. 
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Specifies the cluster host name (alias host identifier). 
Before using this qualifier, first define the same name in the hosts database. 


/CLUSTER=Aost associates the alias host identifier with each interface in a 
cluster. 


/NOCLUSTER disables Internet cluster processing on the specified interface. 


Caution 


When you specify /NOCLUSTER, active communication is aborted for 
applications bound to the cluster alias name. 


/COMPRESS= {ON | OFF | AUTOMATIC} 
Optional. Default: For PPP interface: /COMPRESS=ON; for SLIP interface: 
/COMPRESS=OFF 


Valid for SLIP and PPP interfaces. 
Enables or disables TCP header compression. 


/COMPRESS=AUTOMATIC turns off compression unless the remote end begins 
to use it. 


/DESTINATION=/P_address 
Optional. 


Valid for a PPP interface. 


Used on the local host to provide dialup access to remote systems. The value 
specified is the IP address to be given to remote clients for use while PPP 
connection is active. If you use /DESTINATION, you must provide the address of 
the local host with the /HOST qualifier. 


/DHCP 
Optional. 


Designates the interface as a DHCP-controlled interface in the volatile database. 
This qualifier affects only the currently running interface. 


Before you enter the SET INTERFACE command, be sure to enter the SET 
NOINTERFACE command first and specify the interface you are changing. 


/FLOWCONTROL 
Optional. Default: No flow control. 


Valid for a SLIP interface. Enables the handling of XON and XOFF characters 
to properly interoperate with modems that are configured to interpret these 
characters locally. 


Specify /FLOWCONTROL only if the host at the other end of the line is another 
host running TCP/IP Services. 


/HOST=host 

Required when first setting the interface; optional if the interface is already 
defined. Always required for a SLIP interface. Optional for a PPP interface 
unless you are setting up the local host as a dialup provider by using the 
/DESTINATION qualifier. 
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Examples 


Local host name or IP address using the interface. If this information is not 
specified for a PPP interface, PPP obtains the correct address from the remote 
host. 


If your host is multihomed, specify an address. 
/LOOPBACK 


/NOLOOPBACK 
Optional. Default: /NOLOOPBACK. 


Sets loopback mode. 

/NETWORK_MASK=/P_address 

Required if you use subnets. 

The part of the host field of the IP address identified as the subnet. 
The software calculates the default by: 

e Setting the bits representing the network fields to 1 

e Setting the bits representing the host field to 0 


An IP address consists of a network number and a host number. You can also 
divide the host field into a site-specific subnetwork and host field. 


/PRIMARY 
Optional. 


For DHCP-controlled interfaces, designates the interface from which system-wide 
configuration options (such as the IP address of the BIND server) are used. 


/SERIAL_DEVICE=device 
Required for SLIP and PPP interfaces; otherwise not used. 


Identifies the OpenVMS terminal device used as a serial device. Specify an 
arbitrary terminal device name. (Unlike Ethernet, FDDI, and Token Ring 
interface names, a serial interface name is not related to the OpenVMS device 
name.) 


1. TCPIP> SET INTERFACE SL5 /HOST=LARK /NETWORK_MASK=255.255.255.0 - 
_TCPIP> /SERIAL DEVICE=TTA3: /COMPRESS=ON /FLOWCONTROL 


Configures SLIP interface SL5, using the local IP address assigned to host 
LARK, with a subnet mask of 255.255.255.0. 


The interface uses the terminal device TTA3:. 
The /COMPRESS qualifier enables TCP header compression (CSLIP). 


The /FLOWCONTROL qualifier enables special handling of XON and XOFF 
characters, to ensure proper interoperation with modems that are configured 
to interpret these characters locally. 


2. TCPIP> SET INTERFACE FFO /HOST=KESTREL /NETWORK_MASK=255.255.0.0 = 
_TCPIP> /BROADCAST_MASK=128.30.255.255 /ARP 


For new interface FFO on host KESTREL, sets the network mask to 
255.255.0.0, sets the broadcast mask to 128.30.0.0, enables ARP, and activates 
the interface. 
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TCPIP> SET INTERFACE PPO /SERIAL DEVICE=TTAO: - 
_TCPIP> /HOST=10.10.1.2 /DESTINATION=10.10.1.3 


Configures the interface as a PPP serial device. This command specifies 
that the local host is a dialup provider. The address specified with the 
/DESTINATION qualifier (10.10.1.3) is the address assigned to the client 
system requesting an address. 


Refer to HP TCP/IP Services for OpenVMS Management manual for more 
information on setting up interfaces for SLIP and PPP communication. 


TCPIP> SET NOINTERFACE DE2 
TCPIP> SET INTERFACE DE2 /LOOPBACK 


TCPIP> SET INTERFACE DE2 


Deletes interface DE2, sets loopback mode for testing this interface, and, after 
testing, reactivates it. 
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SET MX_RECORD 


Formats 


Restrictions 


Parameters 


Qualifiers 


For routing mail, adds routing information to the local Mail Exchanger (MX) 
database. 


Each entry contains a list of hosts that can accept mail for the specified 
destination. The list is in order of routing preference. 


The local MX information is stored in the routes database. 


The MX entry is one of the record types in the BIND database. In addition, a 
BIND server might provide an MX record. 


SMTP is designed to determine where the sending system should try to relay 
mail. It is also designed to identify where the sending system actually tries to 
relay mail. To find a destination address, the MX routing lookup process follows 
this sequence: 


1. Local MX database 

2. Remote MX database 

3. BIND database 

4. Local hosts database 

Related command: SHOW MX_RECORD 


SET MX_RECORD destination 
/GATEWAY=host 
/PREFERENCE=n 


SET NOMX_RECORD _ destination 
[ /GATEWAY=host ] 


Requires read and write access to the routes database. 


destination 
Required. 


Host name or domain name to which mail will be sent. 


/GATEWAY=host 
Required with SET MX_RECORD. Optional with SET NOMX_RECORD. 


Gateway through which mail will be relayed. Must have an address in either the 
local hosts database or the BIND database. 


A destination can have multiple gateways, each with an associated preference 
value. 


/PREFERENCE=n 
Required. 
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Arbitrary number for ranking multiple gateways for a destination. The smaller 
the number, the higher the preference in sending mail by way of that gateway. 


Do not use with SET NOMX RECORD. 


Examples 


1. TCPIP> SET MX_RECORD JUNO /GATEWAY=MARS /PREFERENCE=100 
Assigns MARS as the gateway for host JUNO with a preference of 100. 


2. TCPIP> SET MX_RECORD JUNO /GATEWAY=VENUS /PREFERENCE=200 
Assigns VENUS as the gateway for host JUNO with a preference of 200. 
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SET NAME_SERVICE 


Format 


Restrictions 


Qualifiers 


Configures the BIND resolver and designates a BIND server. By default, all 
settings are process specific. 


e To make modifications that are systemwide, use the /SYSTEM qualifier. 


e The local host’s domain is used as the default domain unless you also specify 
/DOMAIN. 


e To reload the BIND server databases, use the /INITIALIZE qualifier. 
e /NOSERVER does not require any options. 


Related commands: SHOW NAME_SERVICE, 
SET CONFIGURATION NAME _SERVICE 


SET NAME_SERVICE — [ /CLUSTER=dev:{directory| | 
[ /DISABLE ] 
[ NO]DOMAIN=domain | 
[ /ENABLE ] 
[ INITIALIZE ] 
[ [NOJPATH=domain | 
[ /RETRY=number of retries | 
[ [NOJSERVER=host | 
[ SYSTEM ] 
[ /TIMEOUT=seconds ] 
[ TRANSPORT=protoco! | ) 


The /SYSTEM qualifier requires SYSPRV or BYPASS and SYSNAM privileges. 
The /INITIALIZE qualifier requires BYPASS, READALL, or SYSPRV privileges. 


/CLUSTER=dev:|directory] 
Optional. 


Specifies the common BIND directory. By default, the clusterwide common 
directory is common-disk:[TCPIP$BIND_COMMON]. This qualifier reloads the 
BIND database on every master BIND server running in the OpenVMS Cluster. 


This qualifier must be used with the /INITIALIZE qualifier. 

/DISABLE 

Optional. 

Disables the BIND resolver. All name and address lookups are now directed to 


the local hosts database. Use with /SYSTEM. 


/DOMAIN=domain 
/NODOMAIN=domain 
Optional. 


Defines the default domain. The default domain is appended to host name 
references made from the local process. 
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/NODOMAIN deletes the process-specific definition of the domain. Do not use 
with /SYSTEM. 


/ENABLE 
Optional. Default: Not enabled. 


Enables the BIND resolver. Must be used with /SYSTEM. 


AINITIALIZE 
Optional. Default: No reloading. 


Reloads all BIND server databases and the BIND configuration file. Either 
TCPIP$ETC:RNDC.CONF or TCPIP$ETC:RNDC.KEY must be set up to allow 
for secure communication between the user and the BIND server. For more 
information, refer to the HP TCP/IP Services for OpenVMS Management manual. 


/PATH=domain 
/NOPATH=domain 
Optional. 


Defines the BIND resolver’s domain search list. 


To specify multiple domains, list them by search preference. The resolver starts 
with the first domain on the list, and continues to search each domain until the 
name is found or until all domains have been exhausted and the lookup fails. 


/NOPATH removes domains from the list. 


If you define a domain list and then issue another SET NAME_SERVICE /PATH 
command, TCP/IP Services appends the new domains to the end of the list. 


If no search list is defined, the default behavior of the BIND resolver is to do a 
lookup on the name as you typed it. If that lookup fails, then the default domain 
is appended and the lookup is attempted again. 


/RETRY=number of retries 
Optional. Default: four retries. 


Specifies the number of times that the BIND resolver attempts to contact a BIND 
server if previous tries fail. 


/SERVER=host 
/NOSERVER=host 
Optional. 


Specifies the host name or address of the BIND server or servers that the resolver 
will query. 


To specify multiple hosts, list them by request preference. The resolver sends the 
first lookup request to the first host on the list. 


/NOSERVER removes hosts from the list. 


If you define a server list and then issue another 
SET NAME_SERVICE /SERVER command, TCP/IP Services appends the new 
servers to the end of the list. 


Do not use /NOSERVER with /SYSTEM. 


/SYSTEM 
Optional. Default: Changes are process specific. 
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Makes your settings systemwide. 


/TIMEOUT=seconds 
Optional. Default: 4 seconds. 


Specifies the timeout interval for the BIND resolver’s requests to a server. 


When the BIND resolver is used by the auxiliary server, the following conditions 
are true: 


The number of retries is one. 
The timeout interval is 1 second. 


The timeout interval increases by the power of two for each retry, as shown in 
the following table: 


If Retries=4 
Current settings: and Timeout=4 
Retry Timeout interval is: 
First 4 seconds 
Second 8 seconds 
Third 16 seconds 
Last 32 seconds 


Total = 1 minute for one server 


If a second BIND server exists and both servers 
time out, total = 2 minutes 


/TRANSPORT=protocol 
Optional. Default: UDP. 


Protocol used for communicating with a BIND server. Specify one of the following: 


Examples 


UDP 
TCP 


TCPIP> SET NAME SERVICE /SERVER= (PARROT, SORA, JACANA) /SYSTEM /ENABLE 
Defines hosts PARROT, SORA, and JACANA as systemwide BIND servers. 
Also enables the BIND resolver. 

TCPIP> SET NAME SERVICE / SERVER=OSPREY 


For your process, defines host OSPREY as the BIND server. The servers that 
are defined systemwide will not be queried. 
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SET NETWORK 


Format 


Restrictions 


Parameters 


Qualifiers 


Defines or deletes an entry in the networks database. 
Equivalent to maintaining the /etc/networks file on UNIX hosts. 
Related commands: SHOW NETWORK, CONVERT/VMS NETWORK 


SET [NOJNETWORK _ network 
[ /ADDRESS=!/P_address | 
[ /[NOJALIAS=alias | 
[ /[NO|CONFIRM ] 


Requires read, write, and delete access to the networks database. 


network 
Required. 


Name of the network. 


You cannot delete a network by specifying an alias name. 


/ADDRESS=/P_address 
Required for a new entry. 


IP address of the network. 


/ALIAS=alias 
/NOALIAS=alias 
Optional. 


Alternate name for the network. 

e Do not use with SET NONETWORK. 
e /NOALIAS=alias deletes an alias. 

e /NOALIAS=* deletes all aliases. 


/CONFIRM 
NOCONFIRM 
Optional. Default: /CONFIRM if you use a wildcard. 


When used with SET NONETWORK, prompts you to confirm the delete request. 


If you specify the /NOCONFIRM qualifier, the operation is performed without 
asking you to confirm the request. 
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Examples 


1. TCPIP> SET NETWORK MYNA /ADDRESS=128.30.30.10 /ALIAS=MYNA_1 
Creates an entry for network MYNA at IP address 128.30.30.10, and its alias 
MYNA_1, to the networks database. 

2. TCPIP> SET NETWORK MYNA /ALIAS=MYNA_2 
Adds a second alias for network MYNA. 


38. TCPIP> SET NETWORK MYNA /NOALIAS=MYNA_2 


Deletes the alias MYNA_2 from the network MYNA entry in the networks 
database. 


4. TCPIP> SET NETWORK "jungle" /ALIAS=("parrot","canary","motmot") 


For network jungle, creates the aliases parrot, canary, and motmot. 
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SET NFS_SERVER 


Format 


Restrictions 


Qualifiers 


Modifies dynamic configuration parameters that control NFS server operation. 


To modify a dynamic configuration parameter, use one or more of the command 
qualifiers. 


Static configuration parameters can take effect only by restarting the NFS 
server. For more information, refer to the HP TCP/IP Services for OpenVMS 
Management manual. Edit the TCPIP$SETC:SYSCONFIGTAB.DAT file to modify 
static configuration parameters, as explained in the HP TCP/IP Services for 
OpenVMS Tuning and Troubleshooting manual. 


Related commands: SHOW NFS_SERVER, ZERO NFS_SERVER 


SET NFS_SERVER [ /DISABLE=NOPROXY |] 
[ /ENABLE=NOPROXY |] 
[ /GID_DEFAULT=n ] 
[ [NACTIVITY_TIMER=n ] 
[ /UID_DEFAULT=n ] 


Requires the following privileges: 
e SYSNAM 

e WORLD 

e SYSPRV or BYPASS 


/DISABLE=NOPROXY 

Optional. Default: If the SYSCONFIG attribute noproxy enabled is set to 0, 
then proxies are required for server access. Otherwise, the values of noproxy uid 
(for the user ID) and noproxy_gid (for the group ID) become the default for users 
who have no proxies defined. 


Disables the use of default UIDs and GIDs. 


/ENABLE=NOPROXY 
Optional. 


Enables the use of default UIDs and GIDs. 


/GID_DEFAULT=n 
Optional. Default: —2. 


Default GID associated with files owned by a UIC that has no corresponding 
proxy mapping. 


ANACTIVITY_TIMER=n 
Optional. Default: 120 seconds. 


Maximum time period (in seconds) that unaccessed NFS files remain open. 
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/UID_DEFAULT=n 
Optional. Default: —2. 


Default UID associated with files owned by a UIC that has no corresponding 
proxy mapping. 


Examples 


1. TCPIP> SET NFS_ SERVER /INACTIVITY_TIMER=180 


Sets the time period that unaccessed NFS files remain open to 180 seconds. 
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SET PROTOCOL 


Sets parameters for ICMP, IP, TCP, and UDP. 
Related commands: SET CONFIGURATION PROTOCOL, SHOW PROTOCOL 


Format 
SET PROTOCOL ICMP [ /[NOJREDIRECT ] 


SET PROTOCOL IP_ [ /[NOJFORWARD |] 
[ /REASSEMBLY_TIMER=seconds ] 


SET PROTOCOL TCP [ [NOJMTU_SEGMENT_SIZE ] 
[ INO]DELAY_ACK ] 
[ /DROP_COUNT=n ] 
[| /PROBE_TIMER=seconds |] 
[ /QUOTA=[ SEND=bytes, RECEIVE=bytes | 
[ NO]WINDOW_SCALE ] 


SET PROTOCOL UDP [ /[NO]JBROADCAST | 
[ /QUOTA=options | 
Restrictions 
Requires OPER privilege. 


Parameters 


{ICMP | IP | TCP | UDP} 
Required. 


Specifies the protocol software to configure. 


Qualifiers for ICMP 


/REDIRECT 
/NOREDIRECT 
Optional. Default: /NOREDIRECT. 


Sends ICMP_REDIRECT messages. 


Qualifiers for IP 


/FORWARD 
/NOFORWARD 
Optional. Default: /NOFORWARD. 


Forwards IP messages to other hosts. 


/REASSEMBLY_TIMER=n 
Optional. Default: 7 seconds. Valid range: 1 to 126. 


Maximum time for trying to reassemble a received datagram. 
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Qualifiers for TCP 


/MTU_SEGMENT_SIZE 
/NOMTU_SEGMENT_SIZE 
Optional. Default: /NOMTU_SEGMENT_SIZE. 


If a connection is more than one hop away, sets the segment size. Specify one of 
the following: 


/MTU_SEGMENT_SIZE Sets the segment size as close as possible to the 
maximum transmission unit (MTU) size. 


/NOMTU_SEGMENT_SIZE Sets the segment size as close as possible to the 
standard 512 bytes. 


/DELAY_ACK 
/NODELAY_ACK 
Optional. Default: /DELAY_ACK. 


Enables or disables a delay before sending the following acknowledgments: 


/DELAY_ACK ACKs are generated with a delay. 
/NODELAY_ACK ACKs are generated without any delay. 
/DROP_COUNT=n 

Optional. 

Number of idle probes that can go unsatisfied before the software declares a TCP 
connection dead and closes it. 

/PROBE_TIMER=n 

Optional. Default: 75 seconds. 


Number of seconds between probes for idle TCP connections (when the 
SO_KEEPALIVE option is set). If the remote system fails to respond, the 
connection is removed. Also, when initiating a TCP connection request, indicates 
the maximum number of seconds that the software waits for a response from the 
remote system before the request times out. 


/QUOTA=[SEND=bytes, RECEIVE=bytes] 
Optional. 


Queue size (in bytes) for messages. 

The options for setting TCP message queue size are: 

e RECEIVE:n — Receive queue size. Default: 4096 bytes. 
e SEND:n — Send queue size. Default: 4096 bytes. 


/WINDOW_SCALE 
/NOWINDOW_SCALE 
Optional. 


Turns TCP window scaling on and off. Default is on. 


Scaling allows windows larger than 64 KB to be represented in the normal 16-bit 
TCP window field. Large windows allow improved throughput. Turning this 
option off may help you to troubleshoot communication problems with another 
TCP/IP implementation. 
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Qualifiers for UDP 


Examples 


/BROADCAST 
/[NO]BROADCAST 
Optional. Default: /NOBROADCAST. 


Enables privilege checking for broadcast messages. 
e /BROADCAST — Nonprivileged users can send broadcast messages. 


e /NOBROADCAST — To send broadcast messages, users need a privileged 
UIC or the SYSPRV, BYPASS, or OPER privilege. 


ONC RPC applications use broadcast messages and need privilege checking 
disabled. 


/QUOTA=options 
Optional. 


Specifies the queue size (in bytes) for messages. 

The options for setting UDP message queue size are: 

e RECEIVE:n — Receive queue size. Default: 9000 bytes. 
e SEND:n — Send queue size. Default: 9000 bytes. 


1. TCPIP> SET PROTOCOL IP /FORWARD 


Sets IP to forward messages to other hosts, including other Internet cluster 
nodes. 


2. TCPIP> SET PROTOCOL TCP /PROBE_TIMER=50 


Sets the TCP probe timer parameter to 50 seconds. 
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SET ROUTE 


Defines a routing path in either the permanent or volatile routes database. 


Routes in the permanent, on-disk routes database are static. Static routes can be 
supplemented by routes that the dynamic routing server receives. Defaults are as 
follows: 


e Ifthe network is not active, the command affects the permanent database. 


e If the network is active, the command affects the volatile database. (To 
modify the permanent database, use the /PERMANENT qualifier.) 


Note the following restrictions: 
e You can add routes. 


e You cannot use SET NOROUTE to remove a route that is maintained by the 
route daemon. 


e To have full manual control over your routing table, first issue STOP 
ROUTING and then use SET NOROUTE. 


e SET NOROUTE does not require any qualifiers. 
Related commands: SHOW ROUTE, STOP ROUTING 


Note 


HP strongly recommends that you do not specify alias names with the 
destination parameter or with the /GATEWAY=Aost qualifier. 


Format 


SET [NOJROUTE destination 
[ [NOJ]CONFIRM ] 
[ /DEFAULT_ROUTE ] 
[ /GATEWAY=host ] 
[ /MASK=mask_length | 
[ NETWORK ] 
[ PERMANENT |] 

Restrictions 
Requires OPER privilege if: 
e The TCP/IP Services product is running. 


e The routes database requires read and write access. 


Parameters 


destination 
Required unless you specify the /DEFAULT_ROUTE qualifier. 


Host or network through which to route packets. Specify one of the following: 
e A host, as it is defined in the hosts database 


e A network, as it is defined in the networks database 
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Not valid with /DEFAULT_ROUTE. 


/CONFIRM 
/NOCONFIRM 
Optional. Default: /CONFIRM if you use a wildcard. 


Prompts you to confirm the change. 


If you specify the /NOCONFIRM qualifier, the operation is performed without 
asking you to confirm the request. 


/DEFAULT_ROUTE 
Optional. Default: 0.0.0.0. 


Defines a second route to use if the first try to route a packet fails. 
You must also specify a value for /GATEWAY. 


Not valid with the destination parameter. 


/GATEWAY=host 
Optional. Default: None. 


Gateway for the route. Necessary to send packets to a host on another network. 


/MASK=mask_length 
Optional. Default: None. 


Defines the Classless Inter-Domain Routing (CIDR) mask length. (The mask 
length is sometimes referred to as the prefix length.) 


CIDR is a method of associating blocks of Internet addresses through the use 
of a mask. With CIDR, a route is a combination of the IP address and a value 
describing the length of the leftmost contiguous set of bits. 


/NETWORK 
Optional. Defaults: 


e Destination is classified based on its Internet network class (A, B, or C). 


e Ifthe address is clearly a network number, SET ROUTE interprets the 
number correctly. 


Defines the route as a network route. 


Use this qualifier if the network number could be misinterpreted as an IP host 
address; for example, if a network mask is nonstandard, or if the IP address is 
abbreviated. 


This qualifier is required if you are creating a network route that specifies a 
CIDR mask (for example, /MASK=mask_length). 


/PERMANENT 
Optional. Defaults: 


If the network is not active, the permanent routes database is changed. If the 
network is active, the volatile routes database is changed. 


Changes only the permanent routes database. 
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Examples 
1. TCPIP> SET ROUTE DODO /GATEWAY=RHEA 


Defines a route for local host DODO to send packets. 


2. TCPIP> SET ROUTE 101.81 /GATEWAY=100.42 


Defines a gateway for routing packets for the host with IP address 101.81. 


3. TCPIP> SET ROUTE 100.45.0 /GATEWAY=REMOTE /NETWORK 
Sets a route through the network whose IP address is 100.45.0. 


4, TCPIP> SET ROUTE /DEFAULT /GATEWAY=DEFGATE /PERMANENT 


Sets a default route with host DEFGATE as the default gateway. Adds the 
definition to the permanent routes database. 
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SET SERVICE 


Format 


Restrictions 


Defines a new entry or modifies an existing entry in the services database. 


The /FILE, /PORT, /PROCESS_NAME, and /USER_NAME qualifiers are required 
when defining a new entry and optional when modifying an existing one. 


Related command: SHOW SERVICE 


SET [NOJSERVICE service 
{ /FILE=startup_file 
/PORT=n 
/PROCESS_NAME=process 
/USER_NAME=vms_user_account } 
[ /ACCEPT=options | 
[ /ADDRESS=I/P_address ] 
[ /FLAGS=options | 
[ /LIMIT=n | 
[ /LOG_OPTIONS=options ] 
[ /PROTOCOL=protocol=options | 
[ /REJECT=options ] 
[ /RPC=values | 
[ /SEPARATOR=option | 
[ SOCKET_OPTIONS=options ] 


You cannot modify the following fields in an existing entry: 

e service 

e /ADDRESS 

e /PORT 

e /PROCESS_NAME 

e /PROTOCOL (except for the optional settings) 

To make changes to these fields, use SET NOSERVICE to delete the entry and 


then re-create the entry. 


Note 


There is no RCP service. RCP uses the RSH server process. 


HP strongly suggests that, for the services provided by TCP/IP Services, you do 
not use this command to reset the following: 


e The required qualifiers 


e The /FLAGS qualifier, except for the APPLICATION _PROXY and 
CASE_INSENSITIVE options 


Using SET NOSERVICE without either a specified service or specified qualifiers 
deletes all entries for all services. 
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Requires write access to the directory with the services database. 


Parameters 


service 
Required for SET SERVICE; optional for SET NOSERVICE. 


Service you want to modify or enter into the services database. 


Qualifiers 


/ACCEPT {=[NO]JHOSTS=(hosts) | =|[NOJNETWORKS=(networks)} 
Optional. Default: Offers the service to all hosts on all networks. 


e /ACCEPT=HOST=(host) 
— Grants host or hosts access to the service. 
— Denies access to all other hosts. 


e /ACCEPT=NOHOST=host removes access to the service for a host that 
previously gained access with /ACCEPT=HOST. 


The following options are available: 


Option Meaning 


HOSTS=hosts Makes the service available to the specified hosts. 
Denies all other hosts access to the service. 


Maximum is 32. 


Example: 
/ACCEPT=HOSTS=( host1_name,host2_name,host3_address) 


NOHOSTS=hosts Removes the specified hosts from the accept list so they cannot gain access to the 
service. You can specify a wildcard character (*) in place of the hosts list to remove all 
hosts from the accept list. 


Maximum is 32. 


Example: 
/ACCEPT=NOHOSTS=(host1_name,host2_name,host3_address) 


NETWORKS=networks Makes the service available to the specified networks. Denies access to the service to all 
other networks. 


Maximum is 16. 


For each network, you can optionally specify the network mask. The default network 
mask equals network’s class number. For example, for the network 11.200.0.0., the 
default mask is 255.0.0.0. 


Example: 


/ACCEPT=NETWORKS=(net1_name,net2_address,net3:net3mask) 


NONETWORKS[=networks] Removes the specified networks from the accept list so they cannot gain access to the 
service. You can specify a wildcard character (*) in place of the networks list to remove 
all networks from the accept list. 


Maximum is 16. 


For each network, you can optionally specify the network mask. The default net mask 
equals network’s class number. For example, for network 11.200.0.0., the default mask 
is 255.0.0.0. 


/ACCEPT=NONETWORKS=(net1_name,net2_address,net3:net3mask) 
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/ADDRESS=/P_address 
Optional. Default: 0.0.0.0 (all local interfaces receive incoming requests for the 
service). 


If you have multiple Internet interfaces and, therefore, more than one IP address, 
/ADDRESS specifies the particular address on which incoming requests are 
received. 


To define a service name more than once, use /ADDRESS with different values 
for each instance. A reason to duplicate a service name, for example, is that your 
local host has three interfaces and you want to make a service available on two of 
them. Each service/interface pair must be unique. 


/FILE=startup_file 

Required if defining a new service entry; optional if modifying an existing one. 
Name of the service’s startup command file. 

/FLAGS= {[NO]JAPPLICATION_PROXY | [NO]JMULTITHREAD | [NO]PROXY | 


[NO]JCASE_INSENSITIVE} 
Optional. 


The flag options are: 
e [NOJAPPLICATION_PROXY. Default: NOAPPLICATION_PROXY. 


The service does its own proxy checking. This allows connections based on 
defined proxies. 


Applies to: remote shell (RSH) and line printer daemon (LPD). 


Note 


The ROOT account does not require a communication proxy in the proxy 
database. The setting of /FLAGS=APPLICATION_PROXY flag is not 
relevant. 


e [NO]MULTITHREAD. Default: NOMULTITHREAD. 


While connecting a socket to a remote host and passing the socket to the 
requested server, the auxiliary server continues to listen for incoming 
requests. 


e [NO]PROXY. Default: NOPROXY. 
User account information is from the proxy database. 
e [NO]CASE_INSENSITIVE. Default: CASE_INSENSITIVE. 


Case sensitivity of the remote user name in the proxy database. 
Use with /PROXY. 


/LIMIT=n 
Optional. 


Maximum number of copies of the requested service allowed to run on the system. 
If the maximum number is reached, any additional requests for the service are 
rejected. 
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/LOG_OPTIONS= 

[ [NOJACCEPT ] 

[ [NOJACTIVATE ] 

[ [NOJADDRESS ] 

[ [NOJALL ] 

[ [NO]JCONNECT ] 

[ [NO]DEACTIVATE ] 
[ [NOJERROR ] 


[ [NOJEXIT_CLEANUP ] 


[ [NOJLOGIN ] 

[ [NO]LOGOUT ] 
[ [NO]MODIFY ] 

[ [NO]REJECT ] 


Sets the specified logging options for the service you are configuring. 


The logging options have the following meanings: 


Option Meaning 

[NOJACCEPT Message is logged when a request is accepted. 

[NOJACTIVATE Message is logged when the service is activated. 

[NOJADDRESS For auxiliary server messages and OpenVMS security 
events, the message displays the IP address as a host 
name. If host names are not relevant, HP recommends 
that you specify [NO]JADDRESS. 

[NOJALL Messages are logged for all events. 

[NO]JCONNECT Message is logged when the auxiliary server issues a 
connect request back to the client. The services that 
usually make this request (on a second socket) are 
remote shell and remote execute. 

[NO]DEACTIVATE Message is logged when the service is being 
deactivated. 

[NOJERROR Message is logged when an error is detected while 


[NO]JEXIT_CLEANUP 


processing a request to the service. 


Message is logged when the service fails to complete 
startup (that is, the server did not assign the BG 
device, with logical name SYS$NET, or did not issue a 
C socket before exiting). 


[NO]LOGIN Message is logged when a connected terminal server 
accepts a remote login request. 

[NO]JLOGOUT Message is logged when a connected terminal server 
terminates a connection. 

[NO]MODIFY Message is logged when the active service is being 
modified. 

[NO]REJECT Message is logged when a request is rejected. 

/PORT=n 


Required if defining a new service entry. Cannot be modified; use SET 
NOSERVICE to delete the entry and then re-create the entry with the 
modification you want to make. 


Port number that the service will use. Specify a number from 1 to 65535. 
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/PROCESS_NAME=process 

Required if defining a new service entry. Cannot be modified (use SET 
NOSERVICE to delete the entry and then re-create the entry with the 
modification you want to make). 


Name of the service’s process. 


Specify a character string up to 15 characters long. The name is truncated to 15 
characters if it exceeds that limit. 


/PROTOCOL=protocol! [=options] 
Optional. Default: TCP. 


Protocol, and its parameters, that the service will use. To set these parameters, 
use the following options: 


Protocol Option Meaning 
IP TYPE_OF_SERVICE=n Type of service, expressed as a 
value between 0 and 255. 
TIME_TO_LIVE=n Maximum number of hops that 


packets can traverse before 
being dropped. 


TCP [NO]DELAY Delays sending packets, 
(stream allowing multiple packets to 
socket be combined into a single larger 
type) packet before transmission. 
Default: DELAY. 
DROP_COUNT=n TCP connection-request timeout 


interval for the service. 


Maximum number of seconds to 
probe for idle TCP connections 
before such a connection times 
out and closes. 


PROBE_TIMER=seconds Number of seconds between 
probes for idle connections. 


UDP None Datagram socket type. 


/REJECT {=[NO]JHOSTS=(hosts) |=[NO]JNETWORKS=(networks) 

| =[NO]MESSAGE="text"] } 

Optional. Default: No rejections if /ACCEPT is set to its default (service all 
hosts). 


e /REJECT=HOST=host denies host access to the service. 
e /REJECT=NOHOST=Aost regrants host access to the service. 


The following options are available. 


Command Descriptions 2-147 


SET SERVICE 


Option 


Meaning 


HOSTS=hosts 


NOHOSTS=hAosts 


NETWORKS=networks 


NONETWORKS[=networks] 


[NO]MESSAGE=text 
NOMESSAGE 


Makes the service unavailable to the specified hosts. 
Maximum is 32. 

Examples: 

/REJECT=HOSTS=(host1_name,host2_name, host3_address) 
/REJECT=HOSTS=* 


Removes the specified hosts from the reject list. You can use the wildcard character (*) 
in place of the hosts list to remove all hosts from the reject list. 


Maximum is 32. 

Examples: 
/REJECT=NOHOSTS=(host1_name,host2_name,host3_address) 
/REJECT=NOHOSTS=* 

Makes the service unavailable to the hosts on the specified networks. 
Maximum is 16. 


For each network, you can optionally specify the network mask. The default net mask 
equals network’s class number. For example, for network 11.200.0.0., the default mask 
is 255.0.0.0. 


Example: 
/REJECT=NETWORKS=(net1_name,net2_address, net3:net3mask) 


Removes the specified networks from the reject list. You can use the wildcard character 
(*) in place of the networks list to remove all networks from the reject list. 


Maximum is 16. 


For each network, you can optionally specify the network mask. The default net mask 
equals network’s class number. For example, for network 11.200.0.0., the default mask 
is 255.0.0.0. 


Example: 
/REJECT=NONETWORKS=(net1_name,net2_address, net3:net3mask) 


Message sent to "reject-list" clients when TCP/IP Services rejects their request for the 
service. 


Optional. 

Specify a character string up to 63 characters. 

Enclose the string in quotation marks. 

Use this option only for a service whose clients require and support reject messages. 
Messages are sent with a carriage return/line feed at the end. 


For RLOGIN, RSH, and REXEC, this message is preceded by a byte with a value of 1 
and is terminated with a byte with a value of 0. 


/REJECT=NOMESSAGE deletes the stored message text. 


/RPC=(PROGRAM_NUMBER=n, VERSION_NUMBER=(LOW=n, HIGH=n)) 
Required for services that use the Portmapper; otherwise, not valid. Defaults: 


Service Program Number Highest Version Lowest Version 
MOUNT 100005 1 1 
NFS server 100003 2 2 
PCNFS 150001 a 2 
PORTMAPPER 100000 1 1 


Information that identifies the service to the Portmapper. Use this qualifier for 
all applications that use RPCs. 
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SET SERVICE 


/SEPARATOR=option=character 
Optional. Default: 0 (null). 


Character that separates the following fields in received packets: 
e PORT=character 

e USER_NAME=character 

e PASSWORD=character 

e COMMAND=character 


/SOCKET_OPTIONS=(options) 
Optional. 


The following socket options are available. 


Option Description Default 

BROADCAST Sockets are UDP Null character (hexadecimal 00) 
broadcast. 

NOBROADCAST _ Sockets are not UDP 
broadcast. 

KEEPALIVE Sockets are TCP Null character (hexadecimal 00) 
keepalive. 

NOKEEPALIVE Sockets are not TCP 
keepalive. 

RECEIVE Receive socket quota. Null character (hexadecimal 00) 

SEND Send socket quota. Null character (hexadecimal 00) 


/USER_NAME=vms_user_account 
Required if defining a new service entry; optional if modifying an existing service. 


OpenVMS account information for users working on client systems. Required for 
a user to access the service. 


The user must also be defined in the system user authorization file 
(SYSUAF.DAT). 


1. TCPIP> SET SERVICE TOE /USER_NAME=LITTLE PIGGY - 
TCPIP> /PROCESS NAME=TOEd /PORT=1050 /PROTOCOL=UDP - 


_TCPIP> /FILE=SYS$COMMON: [SYSMGR]TOE STARTUP .COM 


Modifies the service TOE to implement UDP on port 1050. This service has 
the OpenVMS process context of user LITTLE_PIGGY. 


After you issue a SET SERVICE TOE command, the auxiliary server executes 
TOE_STARTUP.COM when a request arrives for service TOE. 


2. TCPIP> SET SERVICE LPD - 
_TCPIP> /REJECT=NETWORK=(11.30.0.0:255.255.0.0,11.40.0.0) 


Sets the LPD service to be inaccessible to the two specified networks. 


8. TCPIP> SET SERVICE RSH /FLAGS=(PROXY,CASE_INSENSITIVE) 


Sets the proxy and case-sensitivity flags for the RSH service. 
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SHOW ARP 


Displays ARP information. 
Related command: SET ARP 


Format 
SHOW ARP [hostj 
[/[NO|LOCAL] 
Parameters 


host 
Optional. Default: All hosts; same as specifying /NOLOCAL. 


Specifies the host about which you want information. 


Qualifiers 


/LOCAL 
/[NO]JLOCAL 
Optional. Default: /NOLOCAL. 


If you either omit this qualifier or specify /NOLOCAL, the software checks the 
hosts database. If a lookup fails, it also checks the BIND resolver. 


Limits name-to-address lookups to the local hosts database. 


Examples 


1. TCPIP> SHOW ARP 


Cnt Flags Timer Host Phys Addr 
1: UC 425 * 00-00-£8-40-ad-91 
2: UC 60 150.110.4.191 08-00-2b-39-4b-40 
3: UC 438 150.110.5.117 00-00-£8-8d-24-d4 
4: UCS 878 150.110.5.109 00-00-f8-4f-f1-63 
5: UCS 426 150.110.5.31 08-00-2b-al-b1-93 
7: UC 104 150.110.4.2 aa-00-04-00-6d-10 


Displays the contents of the ARP table. 


The flags have the following meanings: 


Flag Meaning 


Up, or in use 
Complete 
Stale 
Permanent 
Dead 


pVnAnAaAG 


2. TCPIP> SHOW ARP PARROT 
parrot (11.170.6.45) at 08-CC-2B-12-C2-BB 


Displays IP address-to-hardware address mapping for host PARROT. 
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SHOW BOOTP 


Displays client entries in the BOOTP database. 
Related command: SET BOOTP 


Format 


SHOW BOOTP [| host ] 
[| /HARDWARE=ADDRESS=hex_address | 
[ /LOCAL ] 
[| /OUTPUT=file | 


Parameters 


host 
Optional. Default: Displays all entries. 


Host entry you want to display. 


Qualifiers 


/HARDWARE=ADDRESS=hex_address 
Optional. Default: None. 


Identifies the entry by hardware address. 
Specify the address as hh-hh-hh-hh-hh-hh. 


/LOCAL 
Optional. Default: The command checks the hosts database; if a lookup fails, it 
also checks the BIND resolver. 


To display hardware-address/IP-identification matches, limits host-name-to- 
IP-address lookup for each entry in the BOOTP database to the local hosts 
database. 


/OUTPUT=file 
Optional. Default: Screen display. 


Output is directed to the specified file. 


Examples 


1. TCPIP> SHOW BOOTP MYNA /FULL 


Host: 17.22.222.255 myna 
Hardware Address: 07-06-2B-05-04-03 
Network mask: 255.0.0.0 Type: Ethernet 
File: MYNA.SYS 
Time offset: 0 Vendor: Birds, Inc. 
Gateways: not defined 
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Servers: 

Cookie: not defined 

IEN: not defined 
Impress: not defined 

Log: not defined 

LPR: not defined 

Name: owl.wise.mouser.edu 
Resource: not defined 

Time: not defined 

TCPIP> 


Displays the entry for client myna in the BOOTP database. When myna 
requests a download, TCP/IP Services sends system image MYNA.SYS. 
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SHOW COMMUNICATION 


Format 


Qualifiers 


Examples 


Displays the settings and status for the IP, TCP, UDP, and INET_ACP software, 
including routing, buffers, sockets, and memory on the running system. 


Related commands: SET COMMUNICATION 


SHOW COMMUNICATION [ /MEMORY ] 
[ /ROUTE ] 
[ /SECURITY ] 


/MEMORY 
Optional. 


Displays information about memory allocated to data structures associated with 
network operations. 


/ROUTE 
Optional. 
Displays routing statistics. 


/SECURITY 
Optional. 


Displays the security settings specified with the following SET 
COMMUNICATION qualifiers: 


e /ACCEPT 
e = /REJECT 


1. TCPIP> SHOW COMMUNICATION/ROUTE 
Route statistics 


Created by redirects 
Modified by redirects 
Wildcarded lookups 


Invalid redirect calls 
Failed lookups 


oo noo 


Displays routing statistics. 
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2. TCPIP> SHOW COMMUNICATION /MEMORY 
1585 mbufs in use: 

490 mbufs allocated to data 
221 mbufs allocated to ancillary data 
2 mbufs allocated to packet headers 
131 mbufs allocated to socket structures 
198 mbufs allocated to protocol control blocks 
180 mbufs allocated to routing table entries 
246 mbufs allocated to socket names and addresses 
21 mbufs allocated to socket options 
76 mbufs allocated to interface addresses 
1 mbufs allocated to kernel table 
2 mbufs allocated to ip multicast options 
7 mbufs allocated to ip multicast address 
10 mbufs allocated to interface multicast addess 
1 mbufs allocated to <mbuf type 100> 
1 mbufs allocated to <mbuf type 108> 
3 mbufs allocated to <mbuf type 109> 
7 mbufs allocated to <mbuf type 112> 
28 mbufs allocated to <mbuf type 113> 
28 mbufs allocated to <mbuf type 114> 
3 mbufs allocated to <mbuf type 115> 
3 mbufs allocated to <mbuf type 117> 
5 mbufs allocated to <mbuf type 118> 


Displays information about memory usage. 


3. TCPIP> SHOW COMMUNICATION /SECURITY 
Communication Security Parameters 


Allow Log: Acpt Actv Dactv Conn Error Exit Logi Logo Mdfy Rjct TimO Addr 
Force Log: None 


Security device: disabled 


Access lists 
Accept host: 0.0.0.0 

Accept netw: 0.0.0.0 

Displays information about security parameters that were specified with the 
SET COMMUNICATION command. 
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SHOW CONFIGURATION 


Format 


Parameters 


Displays the information in the configuration database. This database, read by 
the TCP/IP Services startup procedure, holds information to: 


e Configure the lower-layer protocols, including dynamic routing. 

e Configure and enable the Internet interfaces. 

e Configure the services you want enabled when TCP/IP Services starts up. 
e Configure the BIND resolver. 

e Configure the BIND server, including the default domain. 

e Configure SMTP. 

e Configure SNMP. 

e Configure TIME. 

e Map file systems. 


Because the SET CONFIGURATION commands do not take effect until the 

next time TCP/IP Services starts up, the SHOW CONFIGURATION command 
might not display the current settings for the running software. For example, the 
information you see from SHOW CONFIGURATION PROTOCOL might differ 
from the SHOW PROTOCOL /PARAMETERS output. 


Related commands: All SET CONFIGURATION commands 


SHOW CONFIGURATION { component | ENABLE SERVICE [service] | START ROUTING } 
[ COMMON ] 
[ FULL ] 
[ JOUTPUT=file | 


component 
Required if you do not specify ENABLE SERVICE or START ROUTING. 


Component, defined in the configuration database, whose configuration you want 
to display. 

ENABLE SERVICE [service] 

Required if you do not specify the component parameter or START ROUTING. 


Displays either the specified component or all the components that are enabled 
by the TCP/IP Services startup procedure. 


START ROUTING 
Required if you do not specify component or ENABLE SERVICE. 


Shows whether or not routing is configured to start running by the TCP/IP 
Services startup procedure. 


Command Descriptions 2-155 


SHOW CONFIGURATION 


Qualifiers 


/COMMON 
Optional. Default: Node specific. 


Valid only with SHOW CONFIGURATION ENABLE SERVICE. 

Displays the information in the configuration database for the clusterwide 
enabling or disabling of services. 

/FULL 

Optional. The default is to give a brief listing of the information. 

Displays complete information. 

Use with the component parameter. 

/OUTPUT=file 

Optional. Default: Screen display. 

Writes output to the specified file. 


Examples 


1. TCPIP> SHOW CONFIGURATION ENABLE SERVICE 
Enable service 


FIP, FTP CLIENT, LPD, MOUNT, NFS, NFS_CLIENT, PCNFS, 
PORTMAPPER, REXEC, RSH, SMTP, SNMP 


Displays the services configured in the services database that will be enabled 
by the TCP/IP Services startup procedure. 


2. TCPIP> SHOW CONFIGURATION SNMP 
SNMP Configuration 
Flags: AuthenTraps Sets 
Contact: Sam Spade 


Location 
First: Falcon Building 
Second: Los Angeles, California 


Community Type Address list 

public Read 0.0.0.0 

trapit Read Trap 136.20.0.10 

trapit2 Read Trap 136.20.0.12, 136.20.0.15 
rw2 Read Write 136.20.0.15, 136.20.0.100 


Displays the SNMP configuration. 
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TCPIP> SHOW CONFIGURATION NAME SERVICE 
BIND Resolver Configuration 


Transport: UDP 


Domain: fred.parrot.brd.com 
Retry: 4 
Timeout: 4 
Servers: 11.20.208.10, 11.20.208.53 
Path: No values defined 
TCPIP> 


Displays, from the configuration database, the BIND resolver configuration. 
TCPIP> SHOW CONFIGURATION INTERFACE 


Interface: DEl 
IP_ Addr: 11.20.208.100 NETWRK: 255.255.0.0 BRDCST: 11.20.255.255 


Interface: LOO 
IP_Addr: 137..0..0:.1 NETWRK: 255.0.0.0 BRDCST: 
TCPIP> 


Displays the permanent definition of Internet interfaces DE1 and LOO. 
TCPIP> SHOW CONFIGURATION SMTP 


SMTP Configuration 


Options 
Initial interval: 0 00:30:00.00 Address _max: 16 NOEIGHT BIT 
Retry interval: 0 01:00:00.00 Hop_count_max: 16 NORELAY 
Maximum interval: 3 00:00:00.00 TOP_HEADERS 
Timeout Initial Mail Receipt Data Terminate 
Send: 5 5 5 3 10 
Receive: 5 
Alternate gateway: not defined 
General gateway: not defined 
Substitute domain: not defined 
Zone: not defined 
Postmaster: TCPIP SMTP 
Log file: SYSSSPECIFIC: [TCPIP$SMTP]TCPIP$SMTP_LOGFILE.LOG 
Generic queue Queues Participating nodes 
TCPIPSSMTP_CRANE_00 1 CRANE 


Displays the SMTP configuration. 
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SHOW CONFIGURATION PROTOCOL 


Displays information in the configuration database which sets the parameters for 
ICMP, IP, TCP, and UDP when TCP/IP Services starts up. 


Related commands: SET CONFIGURATION PROTOCOL, SET PROTOCOL 


Format 

SHOW CONFIGURATION PROTOCOL [ protocol | 

[ PARAMETERS ] 

Parameters 

protocol 

Optional. Default: All protocols. 

Specify one of the following: ICMP, IP, TCP, UDP. 
Qualifiers 

/PARAMETERS 

Optional. 

Shows parameter settings. You can specify any protocol. 
Examples 


1. TCPIP> SHOW CONFIGURATION PROTOCOL 


ICMP 
Redirect: enabled 
Unreachable: disabled 
IP 
Forward: disabled 
Reassembly timer: 0 
TCP 
Delay ACK: enabled 
Window scale: enabled 
Drop count: 0 
Probe timer: 0 
Receive Send 
Push: disabled disabled 
Quota: 0 0 
UDP 
Unpriv. broadcast: disabled 
Receive Send 
Checksum: enabled enabled 
Quota: 0 0 


Displays information in the configuration database. 
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SHOW DEVICE_SOCKET 


Format 


Parameters 


Qualifiers 


Displays: 
e Device socket counters 
e Current settings from the running communications software 


(A device socket is composed of two parts: the Internet device (interface) and the 
socket.) 


SHOW DEVICE_SOCKET [ device_socket ] 
[ /CONTINUOUS[=n] J 
[ /FULL ] 
[| /HOST=host ] 
[ NOJLOCAL ] 
[ /PORT=n ] 
[ /SERVICE=service | 
[ /TYPE=socket_type | 


device_socket 
Optional. Default: All device sockets. 


Device socket for which you want information. 


Specify the characters BG and the device’s unit number, for example, BG3, BG17. 


/CONTINUOUS[=n] 
Optional. Default: Static display; /CONTINUOUS=4. 


Automatically updates the display. 
Screen update interval in seconds. Valid only for a specific device socket. 


To terminate the display, press Ctrl/C. 


/FULL 
Optional. The default is to give a brief listing of the information. 


Displays complete information, including: 
e Application option settings, for example, ACCEPT or FULL_DUPLEX_CLOSE 
e State of the service 


e Counters for receiving and sending buffers 


/HOST=host 
Optional. Default: All hosts. 


Displays information for device sockets bound to the specified host. 


This does not include device sockets bound to the "ANY host" (address 0.0.0.0). 
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/LOCAL 
/NOLOCAL 
Optional. Default: /LOCAL. 


Displays information for device sockets bound to hosts in the local hosts database. 


/NOLOCAL: Displays information for device sockets bound to hosts in the hosts 
database and hosts known by the BIND resolver. 


/PORT=n 
Optional. Default: All local ports. 


Displays information for device sockets bound to the specified local port. 


/SERVICE=service 
Optional. Default: All services. 


Displays information for device sockets used for the specified service. 


/TYPE=socket_type 
Optional. Default: /TYPE=ALL. 


Displays information for the specified type of device socket. Specify one of the 


following: 
e STREAM 
e DGRAM 


Examples 


1. TCPIP> SHOW DEVICE SOCKET BG21 /FULL 


Device socket: BG21 Type: STREAM 
- LOCAL REMOTE 
Port: 21 0 
Host: * * 
Service: FTP 
RECEIVE SEND 
Queued I/0 0 0 
QOLEN 0 Socket buffer bytes 0 0 
QLEN 0 Socket buffer quota 61440 61440 
QLIMIT 1024 Total buffer alloc 0 0 
TIMEO 0 Total buffer limit 491520 491520 
ERROR 0 Buffer or I/0 waits 1 0 
OOBMARK 0 Buffer or I/O drops 0 0 
I/0 completed 0 0 
Bytes transferred 0 0 


Options: ACCEPT REUSEADR 
State: PRIV 
RCV Buff: WAIT 
SND Buff: None 


Displays complete information about device socket BG21, including the 
options that are set, for example, the FULL_DUPLEX_CLOSE option. 


(With the FULL_DUPLEX_CLOSE option set, the first data transmission on 
a TCP connection that has been closed by the remote application returns an 
EPIPE error. Subsequent send operations on the half-closed socket proceed 
normally.) 
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The following table describes the counters in the first column of the display. 


Counter Meaning 

QOLEN Number of sockets that are about to be connected to the 
specified socket 

QLEN Number of sockets that have established a connection but 
have not yet been accepted by the specified socket 

QLIMIT Number of sockets for the QOLEN and QLEN sockets 

TIMEO Not used 

ERROR Error code temporarily stored on the socket 


OOBMARK Out-of-band mark 


TCPIP> SHOW DEVICE SOCKET BG75 /CONTINUOUS=10 


Displays information about device socket BG75 every 10 seconds. 


TCPIP> SHOW DEVICE SOCKET /HOST="Lark" 


Displays information about all device sockets for remote host lark. 


TCPIP> SHOW DEVICE SOCKET BG1898 


Port Remote 
Device socket Type Local Remote Service Host 
bg1898 STREAM 23 2568 TELNET 16.20.176.227 


Displays socket type, service, and host information for device BG1898. 
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SHOW EXPORT 


Displays disks/directories available for mounting by NFS clients, in the form 
of UNIX path names. It also displays the clients allowed to mount these path 
names. 


Related commands: ADD EXPORT, REMOVE EXPORT, MAP, SET 
CONFIGURATION MAP, SET CONFIGURATION NOMAP, SHOW MAP, SHOW 


CONFIGURATION MAP 
Format 
SHOW EXPORT |[ "/path/name' | 
[ /HOST=host ] 
[ /OUTPUT=file] J 
Restrictions 
Requires read access to the export database. 
Parameters 
"/path/name" 
Optional. Default: All exported file systems. 
Exported files for which to show access rights. 
To specify multiple directory names, separate them with slashes. 
Qualifiers 
/HOST="host_name" 
Optional. Default: All hosts. 
NFS client hosts for which you want to display access rights. 
/OUTPUT=file 
Optional. Default: Screen display. Sends output to the specified file. 
Examples 


1. TCPIP> SHOW EXPORT 


File system Host name 

/TOUCAN TOUCAN, toucan 

/talkers parrot 

/aviary dua0 * 

/condor_root/root condor 

/condor root/work4 condor 

/nene d_ * 

/nfstest unix/larkl * 

/nfstest unix/lark2 * 

/spoonbill dove, nuthatch, dove.tree.branch.com 
toucan, oriole.tree.branch.com 

/spoonbill/birdy dove, DOVE, nuthatch, thrush, 
thrush.tree.branch.com 

/spoonbill/bigbirdy dove 


Displays exported NFS file systems with the clients that have access rights. 
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TCPIP> SHOW EXPORT/HOST="condor" 


File System Host name 
/condor_root/root condor 
/condor_root/work4 condor 


Displays exported NFS file systems for clients on host condor. 
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SHOW HOST 


Format 


Restrictions 


Parameters 


Qualifiers 


Displays information from the hosts database. 


If the BIND resolver is enabled, information from the BIND database is also 
displayed. 


Related commands: SET HOST 


SHOW HOST [ host ] 
[ /ADDRESS=!/P_address | 
[ /DOMAIN=domain | 
[ /LOCAL ] 
[| /OUTPUT=file | 
[ /SERVER=server ] 


Requires read access to the hosts database. 


host 
Optional. Default: All hosts. 


All alias names for the specified host are displayed. 


e Ifa host has more than one IP address and you specify the name, all its 
addresses and aliases are displayed. 


e Ifa host has multiple IP addresses and you specify an alias that is defined on 
multiple IP addresses, only the first IP address and aliases are displayed. 


e Ifyou do not specifiy the host parameter or if you use a wildcard, all hosts 
from the local and BIND databases are displayed. 


e Ifyou use a wildcard to complete a host name, no BIND information is 
displayed. 


e If you specify a host, entries are displayed first from the local hosts database, 
if they exist; otherwise, entries from the BIND database are displayed, if they 
exist. 


/ADDRESS=!P_address 
Optional. Default: None. 


Allows you to select a host by IP address. 


e Ifa host has more than one IP address and you specify the name, all IP 
addresses and aliases for the host are displayed. 


e Ifa host has multiple IP addresses and you specify an alias that is defined on 
multiple IP addresses, only the first IP address and aliases are displayed. 


e Recommended: Use the host parameter instead of this qualifier. 
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Examples 


SHOW HOST 


/DOMAIN=domain 
Optional. Default: Name service domain. 


Domain to be used by the local host. However, the definition of the domain name 
is valid only during the execution of the current SHOW HOST command. The 
BIND request is sent to the specified domain. 


/LOCAL 

Optional. 

Limits name-to-address lookups to the local hosts database. 
/OUTPUT=file 

Optional. Default: Screen display. 

Specifies a file for the output of the SHOW HOST command. 
/SERVER=server 

Optional. Default: Name server list. 


BIND servers to be used. The definition of the server name list is valid only 
during the execution of the current SHOW HOST command. The request is sent 
to the specified server. 


The list is ordered by request preference. For example, the initial request is sent 
to the first host in the list. If that host is unavailable, the request is sent to the 
second host in the list, and so on. 


You can specify a maximum of three servers. 


1. TCPIP> SHOW HOST /LOCAL 


LOCAL database 
Host address Host name 
11.180.6.60 aa80z, AA80Z 


11.180.4.1 abbss.zz3.ddd.com, abbss, ABBSS, ab, a 
11.180.6.8 alibam, ALIBAM, alb 
11.180.5.5 alLpin, ALLPIN, allpine.zz3.ddd.com 
11.180.6.30 amfer, AMFER 
11.180.6.2 ankles, ANKLES 

6.73 auntie, AUNTIE, maitai 


11.180. 


11.180.4.200  zlepin, ZLEPIN 
11.180.20.1 zooley, ZOOLEY, zoo 
11.180.6.37 zxtra, ZXTRA 


The /LOCAL qualifier displays only the hosts in the local database. 
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TCPIP> SHOW HOST ABCXYZ 

BIND database 
Server: 128.182.4.164 ZSERVE 
Host address Host name 
128.180.5.164 ABCXYZ.one.nam.com 


Displays information about a host found in the BIND database. Note that the 
display includes the name and address of the BIND server that supplied the 
information. 


TCPIP> SHOW HOST * 


Displays the entire hosts database and BIND database (if the resolver is 
enabled). 


In the following examples, host heron has the following IP addresses and 
aliases: 


IP 

Address Host Aliases 

100.1 heron HOST_1A 
HOST_1B 
HOST_ALIAS 

100.2 heron HOST 2A 
HOST _ 2B 
HOST_ALIAS 


TCPIP> SHOW HOST HERON 
Shows all the IP addresses and aliases for the host HERON. 


TCPIP> SHOW HOST HOST_1A 

Shows IP address 100.1 and the aliases HOST_1A, HOST_1B, and 
HOST_ALIAS. 

TCPIP> SHOW HOST HOST ALIAS 


Shows the host and all aliases for addresses 100.1 and 100.2. Shows all the 
IP addresses and aliases for host heron. 
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SHOW INTERFACE 


Format 


Parameters 


Qualifiers 


Displays information from the running system for Internet interfaces and 
pseudointerfaces. 


The flags that can appear in the display include: 
e AMCST—The interface will receive multicast packets. 
e BRDCAST—Indicates the interface supports broadcast messages. 


e LOOP—tThe interface is a loopback mode. Packets transmitted on this 
interface will be looped back in the driver and not be transmitted out on 
the network. 


e MCAST—The interface supports multicast packets. However, this does not 
mean that a multicast address is configured for the interface. 


e NOARP—The interface is not using address resolution protocol (ARP). It will 
neither transmit nor respond to ARP requests. 


e PFCPY—AII packets transmitted on this interface are copied and passed to 
the packet filter program. 


e PTP— The interface is point-to-point link. This is a read-only flag that is set 
by the driver. 


e RUN—Indicates the interface is operational. The driver has allocated 
resources for the interface and is ready to transmit and receive packets. 
This option is not applicable to loopback devices, for example, LOO. 


e SMPX—The interface cannot hear its own transmissions. 
e UP—lIndicates the interface is enabled for use. 


e VMTU—tThe interface supports variable maximum transmission unit (MTU) 
sizes. 


Related commands: SHOW CONFIGURATION INTERFACE, 
SET INTERFACE 


SHOW INTERFACE | interface | 
[ CLUSTER ] 
[ FULL ] 


interface 
Optional. Default: All interfaces. 


Specifies the name of an Internet interface or pseudointerface. Examples include 
ZEO, LOO, QE2, QE3. 


/CLUSTER 
Optional. Default: None. 


Displays information about the cluster of which the interface is a member. 
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/FULL 
Optional. Default: Brief description is displayed. 


Displays full information. 


Examples 


1. TCPIP> SHOW INTERFACE WEO /FULL 


Interface: WEO 
IP Addr: 126.65.100.102 NETWRK: 255.255.255.0 BRDCST: 126.65.100.255 
= Ethernet Addr:AA-00-05-CC-2D-2B MTU: 65535 
Flags: UP BRDCST RUN 


RECEIVE SEND 

Packets 3817269 595744 
Errors 0 
Collisions: 0 


Displays information about interface WEO. 
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SHOW MAIL 


Format 


Restrictions 


Parameters 


Qualifiers 


Examples 


Displays SMTP queue information. 
Related commands: REMOVE MAIL, SEND MAIL 


SHOW MAIL [ user ] 
[ /FULL ] 
[ /RECIPIENT[=options] | 
[ /ENTRY=n ] 


Requires SYSPRV or BYPASS privilege to display information for other users. 


user 
Optional. Default: All users. 


Displays SMTP process information of the specified user. 


/FULL 
Optional. Default: Brief description is displayed. 


Displays detailed information. 


/RECIPIENT[=options] 
Optional. Default: ALL. 


Used with /FULL, displays selected recipient classes. Available options include 
the following: 


ALL Shows failed, sent, and unsent mail messages. 

FAILED Shows messages that could not be read for a particular 
recipient. 

SENT Shows successful deliveries to a particular recipient. 

UNSENT Shows messages that are as yet unsent. 

/ENTRY=n 


Optional. Default: Your queue entries. 


Displays information about the specified queue entry number. 


1. TCPIP> SHOW MAIL 


Displays information about mail messages queued to your process’s user 
name. 


2. TCPIP> SHOW MAIL /ENTRY=1234 


Displays information about the mail message 1234 in the queue. 
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3. TCPIP> SHOW MAIL /FULL /RECIPIENT=ALL 


Displays detailed information about all mail messages sent by the user of 
your process’s user name. 
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SHOW MAP 


Displays the names of mapped (logically linked) file systems, also called NFS file 
systems. 


Applies to: NFS server 


Related commands: MAP, UNMAP, ADD EXPORT, SHOW EXPORT, REMOVE 
EXPORT, SET CONFIGURATION MAP, SET CONFIGURATION NOMAP, 
SHOW CONFIGURATION MAP 


Format 

SHOW MAP _[ /path/name } 
Parameters 

/path/name 

Optional. 

Name of the file system (the first element of the UNIX file specification). 
Examples 


1. TCPIP> SHOW MAP 


Dynamic Filesystem Map 


Pathname Logical File System 

/water USERSDKC100: 

/water USERS$DKC100: [WATER ] 
/duck/pond USERS$DKC100: [DUCK. POND. TEAL ] 
TCPIP> 


Displays all mapped file systems. 


2. TCPIP> SHOW MAP "/bird" 


Dynamic Filesystem Map 


Pathname Logical File System 
/bird S$1SDUA7: 
TCPIP> 


Lists mapped file system /bird. 
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SHOW MOUNT 


Displays a list of mounted directories at all mount points or at a particular mount 
point. 


Related commands: MOUNT, DISMOUNT 


Format 


SHOW MOUNT [ device ] 
[ /ALL ] 
[ /FULL ] 
[| /HOST=host | 


Parameters 


device 
Optional. Default: All mounted file systems. 


Local device for which to display mount information. Specify one of the following: 


e DNFSn: — the full NFS device name and directory tree, for example, 
DNFS3:[USER.NOTES] 


e Volume label 
e Logical name for the device 


You can use abbreviations and wildcards. 


Qualifiers 


/ALL 
Optional. 


If you also specify device, displays information for all NFS server hosts with 
mounted file systems on this device. 


If you do not specify device, displays information for all NFS server hosts with 
mounted file systems on any device. 


Not valid with /HOST. 


/FULL 
Optional. Default: Brief description is displayed. 


Displays the full, current operating parameters related to each mount. 


/HOST=host 
Optional. Default: All NFS servers with file systems currently mounted. 


NFS server on which the physical files reside. 
Not valid with /ALL. 
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Examples 


1. TCPIP> SHOW MOUNT 


DNFS1:[000000] automount (inactivity timer 0 00:23:00.00), mounted 
~ SIGMA. PROCESS .COM:/usr 

DNFS2:[000000] mounted 
~ IRIS.PROCESS.COM: /usr/users 


Shows the characteristics of all mounted file systems on all local NFS devices. 


2. TCPIP> SHOW MOUNT DNFS3: /ALL 


DNFS3:[A.B] mounted 

~ SIGMA. PROCESS.COM:/usr 
DNFS3:[A.C] mounted 

- SIGMA. PROCESS. COM: /work 


Shows the characteristics of all mounted file systems on local device DNFS3:. 
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SHOW MX_RECORD 


Displays SMTP routing information. If you omit destination, you see the entries 
in the local Mail Exchange (MX) database. If you specify destination, you see all 
the entries in all the databases that TCP/IP Services would look at, if necessary, 
to resolve the address. 


To send mail, SMTP looks up addresses in one or more databases (if necessary) in 
the following order: 


1. Local MX databse 

2. Remote MX database 

3. BIND server database 

4. Local hosts database 

Related command: SET MX_RECORD 


Format 
SHOW MX_RECORD [ destination | 
[ /GATEWAY=host ] 
[ /OUTPUT=file ] 
Parameters 


destination 
Optional. Default: All entries in the local MX database. 


Final destination host name. 


Qualifiers 


/GATEWAY=host 
Optional. Default: All destinations. 


Displays the destinations that are accessed through the specified gateway. 


/OUTPUT=file 
Optional. Default: Screen display. 


Sends the output to the specified file. 
Examples 


1. TCPIP> SHOW MX_RECORD SWAN 
BIND MX database 


Server: 18.18.218.10 GREAT. HORNED.OWL.COM 

Gate address Preference Gate name 

18.18.218.10 50 WATER. PIPIT.WEBBED.FEET.COM 
18.1.218.16 100 bd-gw.purple.martin.com 
188.88.206.2 200 great. horned.owl.com 
199.9.214.1 300 bird. food.seeds.worms.com 


BIND database 
Server: 18.18.218.10 WATER. PIPIT.WEBBED.FEET.COM 
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Host address Host name 
18.18.100.10 SWAN .WEBBED.FEET.COM 


Displays, in order of preference, the routing hops to reach host SWAN if an 
attempt fails. The local host tries to route through: 


1. WATER.PIPIT.WEBBED.FEET.COM 
2. bd-gw.purple.martin.com 

3. great.horned.owl.com 

4. bird.food.seeds.worms.com 


Both the alternate gateway and the zone affect how SMTP determines where 
to relay nonlocal mail. 


MX records tell mailers where to relay mail that is destined for a given host. 
In the display: 


e The Gate name field tells where to relay the mail. 
e The Gate address field gives the gateway’s IP address. 


e The Preference field gives each MX record a precedence. A lower 
preference number means a higher precedence. 


TCPIP> SHOW MX_RECORD CROW. COM 
BIND MX database 


Server: 18.18.218.10 WATER. PIPIT.WEBBED.FEET.COM 
Gate address Preference Gate name 

159.228.12.253 ih cawcaw.crow.com 
159.228.12.254 2 scare.crow.com 

TCPIP> 


Displays the MX record for destination host crow.com. In the display: 
e The Gate name field tells where to relay the mail. 
e The Gate address field gives the gateway’s IP address. 


e The Preference field gives each MX record a precedence. A lower 
preference number means higher precedence. 


In this example, the local host name is WATER, the alternate gateway is 
scare.crow.com, and the zone is crow.com. The first preference for delivering 
mail to crow.com is to send to cawcaw.crow.com. 


If you have not defined an alternate gateway, SMTP tries to relay the mail 
to scare.crow at IP address 158.228.12.253. It uses the MX records to 
determine the host to which to relay mail. SMTP tries to relay the mail to 
each gateway host, in order of preference, until it either successfully transfers 
the mail or runs out of MX records to try. If there is no alternate gateway, 
the zone is not used. 


If you have defined an alternate gateway, SMTP goes through the list of 

MX records, but it does not automatically try to relay the mail directly to 
the gateway. SMTP checks whether the gateway host name is outside or 
inside the SMTP zone (as defined with SET SMTP CONFIGURATION). If the 
gateway is inside the SMTP zone, SMTP tries to relay the mail directly to the 
gateway host. If the gateway is outside the zone, SMTP sends the mail to the 
alternate gateway. 
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SHOW NAME_SERVICE 


Logs information about the BIND resolver. 


Related commands: SET NAME_SERVICE, 
SHOW CONFIGURATION NAME_SERVICE 


Format 
SHOW NAME_SERVICE — [ /STATISTICS ] 
Restrictions 
The /STATISTICS qualifier requires BYPASS, READALL, or SYSPRV privilege. 
Qualifiers 
/STATISTICS 
Optional. 
Dumps statistics to SYS$SPECIFIC:[TCPIP$BIND]TCPIP$BIND.STATS. 
Either TCPIP$ETC:RNDC.CONF or TCPIP$ETC:RNDC.KEY must be set up to 
allow for secure communication between the user and the BIND server. For more 
information, refer to the HP TCP/IP Services for OpenVMS Management manual. 
Examples 


1. TCPIP> SHOW NAME SERVICE 
BIND Resolver Parameters 
Local domain: TCPIP.OWL.ROC.COM 


System 

State: Started, Enabled 
Transport: UDP 

Domain: tcpip.owl.roc.com 
Retry: 4 


Timeout: 4 
Servers: LOCALHOST, tcpip.owl.roc.com 


Process 

State: Started, Enabled 
Transport: UDP 

Domain: 11.180.34.3 
Retry: 4 


Timeout: 4 
Servers: LOCALHOST, lark, crow.moa.awk.com 
TCPIP> 


Shows systemwide and process-specific parameter settings for the BIND 
resolver. 
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TCPIP> SHOW NAME SERVICE /STATISTICS 


Logs current BIND server statistics to the file 
TCPIP$BIND_SERVER_STATISTICS.LOG. The following sample shows 
such a log file. 


+++ Statistics Dump +++ (922292822) Wed Mar 24 11:27:02 
34250 time since boot (secs) 
15670 time since reset (secs) 


12 Unknown query types 
20000 A queries 
540 SOA queries 
2399 MX queries 
867 ANY queries 
3 AXFR queries 
++ Name Server Statistics ++ 
(Legend) 
RR RNXD RFwdR RDupR- RFail 


RFErr  RErr RAXFR RLame ROpts 

SSysQ  SAns SFwdQ SDupQ SErr 

RQ RIQ RFwdQ RDupQ RTCP 

SFwdR SFail SFErr SNaAns SNXD 
(Global) 

20000 00000 20000 00005 00000 
-- Name Server Statistics -- 
++ Memory Statistics ++ 


3: 9 gets, 2 rem 
4; 7 gets, 0 rem (1 bl, 1022 
5} 16 gets, 1 rem 
6: 7 gets, 5 rem 
7: 10 gets, 5 rem 
8: 97 gets, 16 rem (1 bl, 485 ff) 
13: 6 gets, 4 rem 
664: 5 gets, 1 rem (1 bl, 5 ff) 
732: 2 gets, 0 rem (1 bl, 5 ff) 
1040: 1 gets, 1 rem (1 bl, 2 ff) 
>= 1100: 23 gets, 9 rem 
-- Memory Statistics -- 
--- Statistics Dump --- (907337687) Fri Jan 2 10:14:47 2003 
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SHOW NETWORK 


Displays information about the networks database. 


Related command: SET NETWORK 


Format 


SHOW NETWORK [ network ] 
[| /ADDRESS=address | 
[ /OUTPUT=flle | 


Restrictions 


Requires read access to the networks database. 


Parameters 


network 
Optional. Default: All known networks. 


Network about which to display information. 
e Displays all alias names of the specified network. 
e If you specify an alias, the network name and all its alias names are 
displayed. 
Qualifiers 


/ADDRESS=address 
Optional. Default: None. 


Selects networks by address. 


Not valid with the network parameter. 


/OUTPUT=file 
Optional. Default: Screen display. 


Output is written to the specified file. 


Examples 


1. TCPIP> SHOW NETWORK COBNET 

Network address Network name 

4.0.0.0 COBNET 

Displays the entry for COBNET in the networks database. 
2. TCPIP> SHOW NETWORK 2* 

Network address Network name 


138.180.4.0 zznet, ZZNET 
120.45.30.0 zzo-net, ZZ0-NET, zz0l-net 


From the networks database, displays the entries for all the networks with 
names or aliases beginning with the letter Z. 
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SHOW NFS_SERVER 


Format 


Restrictions 


Qualifiers 


Displays NFS server performance counters and statistics. 
Related commands: SET NFS_SERVER, ZERO NFS_ SERVER 


SHOW NFS_SERVER_[ /CONTINUOUSJ=seconds] } 
[ /RPC] 
[ SERVER ] 
[ VERSION=versions ] 


Requires SYSNAM and WORLD privilege. 


/CONTINUOUS[=seconds] 
Optional. Defaults: Static display; if you specify /CONTINUOUS without a value, 
the default is 4 seconds. 


Provides a dynamic display with optional screen-update interval. 


To terminate the display, press Ctrl/Y. 


/RPC 
Optional. 


Displays only RPC-related performance counters and statistics. 


/SERVER 
Optional. 


Displays NFS server-related performance counters and statistics. 


/VERSION=versions 
Optional. Default: Displays both Version 2 and Version 3. 


Displays version-specific NFS server performance counters and statistics. You can 
specify versions as follows: 


Qualifier Displays 

/VERSION=V2 Only Version 2 
/VERSION=V3 Only Version 3 
/VERSION=(V2,V3) Both Version 2 and Version 3 
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SHOW PORTMAPPER 


Displays a list of all registered remote procedure call (RPC) programs. The 
Portmapper running on the specified host gets this list. 


Format 

SHOW PORTMAPPER | host | 
Parameters 

host 

Optional. Default: Local host. 

Host with the Portmapper you want to query. 
Examples 


1. TCPIP> SHOW PORTMAPPER 


Program Number Version Protocol Port-number Process Service-name 


000186A0 ( 100000) 2 TCP 111 56E0021D PORTMAPPER 
000186A0 ( 100000) 2 UDP 111 56E0021D PORTMAPPER 
000186A3 ( 100003) 3 UDP 2049 56E0021F NFS 
000186A5 ( 100005) 1 UDP 10 56E00220 MOUNT 
000249F1 ( 150001) 1 UDP 5151 56E00222 PCNFS 


Lists information about all of the currently registered applications. 


2. TCPIP> SHOW PORTMAPPER PARROT 


Program Number Version Protocol Port-number Process Service-name 


000186A0 ( 100000) 2 TCP 111 24800126 PORTMAPPER 
000186A0 ( 100000) 2 UDP 111 24800126 PORTMAPPER 


Queries host PARROT for a list of registered applications. 
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SHOW PROTOCOL 


Format 


Parameters 


Qualifiers 


Examples 


Displays statistics and configuration information for the specified protocol. 


Related commands: SET PROTOCOL SET CONFIGURATION PROTOCOL 


SHOW PROTOCOL |[ protocol | 


protocol 


[ PARAMETERS |] 


Optional. Default: All protocols. 
Specify one of the following: ICMP, IP, TCP, UDP. 


/PARAMETERS 


Optional. 


Shows parameter settings. You can specify any protocol. 


1. TCPIP> SHOW PROTOCOL TCP 


tcp: 


64213 packets sent 


56262 data packets (44164814 bytes) 

49 data packets (39372 bytes) retransmitted 
7792 ack-only packets (7923 delayed) 

0 URG only packets 

0 window probe packets 

10 window update packets 

100 control packets 


50000 packets received 


37102 acks (for 44165036 bytes) 

381 duplicate acks 

0 acks for unsent data 

23176 packets (194520 bytes) received in-sequence 
233 completely duplicate packets (290 bytes) 

50 packets with some dup. data (65 bytes duped) 
57 out-of-order packets (43 bytes) 

4 packets (4294967292 bytes) of data after window 
0 window probes 

916 window update packets 

0 packets received after close 

0 discarded for bad checksums 

0 discarded for bad header offset fields 

0 discarded because packet too short 


connection requests 

connection accepts 

connections established (including accepts) 
connections closed (including 3 drops) 


1 embryonic connection dropped 
30253 segments updated rtt (of 30286 attempts) 
14 retransmit timeouts 


0 connections dropped by rexmit timeout 


1 persist timeout 
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2 keepalive timeouts 
2 keepalive probes sent 
0 connections dropped by keepalive 


Displays the TCP statistics. 
The following abbreviations are used for the TCP counters display: 


ack — acknowledge 

URG — urgent 

dup. — duplicate 

embryonic connections—connections not yet established 
rtt — retries 

rexmt — retransmit 


2. TCPIP> SHOW PROTOCOL TCP /PARAMETERS 


TCP 
Delay ACK: enabled 
Window scale: enabled 
Drop count: 8 
Probe timer: 150 
Receive Send 
Push: disabled disabled 
Quota: 32768 32768 


Displays the TCP parameters. 
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SHOW PROXY 


Format 


Restrictions 


Parameters 


Qualifiers 


Displays entries in the proxy database. 
Related commands: ADD PROXY, REMOVE PROXY 


Applies to: NFS server, NFS client, PC-NFS, remote shell, LPR/LPD, and 
customer-developed services 


SHOW PROXY [ user_name | 
[ COMMUNICATION ] 
[ /GID=n ] 
[ /HOST=host ] 
[ /NFS =[options] | 
[ /UID=n | 


Requires read access to the proxy database. 


user_name 
Optional. Default: SHOW PROXY * (all entries). 


Specifies the local OpenVMS identity for the user of the NFS server, NFS client, 
PC-NFS, remote shell, or LPR/LPD. 


/COMMUNICATION 
Optional. Default: Displays both communication and NFS proxies. 


Displays communication proxies. 


/GID=n 
Optional. Default: Displays all NFS proxies. 


Displays the database entries for all clients with the specified GID. 


/HOST=host 
Optional. Default: Displays information for all hosts (same as /HOST="*). 


Specifies the remote host from which information is to be displayed. 
/NFS=option 

Optional. Default: 

e If you omit this qualifier, displays both communication and NFS proxies. 
e If you omit option, displays both incoming and outgoing proxies. 


Displays NFS proxies. 
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These entries might be for local clients, remote clients, or PC-NFS clients. You 
can include the following options: 

/NFS=OUTGOING Proxy to use NFS client 

/NFS=INCOMING Proxy to use NFS server 
/NFS=(OUTGOING,INCOMING) | Proxy to use both the NFS client and the NFS 


/UID=n 


server 


Optional. Default: All NFS proxies. 
Displays the database entry for the client with the specified UID. 


Examples 


1. TCPIP> SHOW PROXY /NFS 


VMS User _name Type User_ID Group ID Host_name 
WEBSTER oD 311 10 =—* 
SHERMAN ND 115 100 * 
COHEN OND 115 10. =—* 
SILK ON 115 IQ 


Shows the NFS entries in the proxy database: 


WEBSTER has authorization to use the local NFS client (outgoing rights). 
SHERMAN can use the local NFS server (incoming rights). 
COHEN can use both the NFS server and client. 


SILK can use both the NFS server and client. This information is not 
currently known to NFS because SILK is not loaded in the dynamic 
database. 


In the display, the values in the Type field mean: 


N NFS server 

O NFS client 

ON NFS server and client 

Cc Communication 

OD, ND, Loaded in the NFS cache 

OND 

CD Loaded in the communication cache 


To set up N, O, or ON proxies, see ADD PROXY 
/NFS=INCOMING=OUTGOING. 
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TCPIP> SHOW PROXY /COMMUNICATION 


VMS User _name Type Remote User_name 
BLUEJAY cD JAY 

QUETZAL cD quetzal 

FALCON cD FALCON 

MYNA G MYNA 

CANVASBACK cD CBACK 


Shows all the communication proxies. 


SHOW PROXY 


Host_name 


* 
central.america.com 
HAWK 

PARROT, parrot 

DUCK, duck 
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SHOW ROUTE 


Displays the permanent or volatile routes database. To display the permanent 
database, use the /PERMANENT qualifier. 


Looks up the destination you specify first in the hosts database and then, if this 
lookup fails, in the networks database. 


Displays the following routes and their types: 

e A W— Active route (created manually or associated with an interface) 

e D— Dynamic route (created by ROUTED or GATED routing daemon) 
e HW— Host route (a route to a host) 

e NW— Network route (a route to a network) 

e P— Permanent (from the routes database) 

Related command: SET ROUTE 


Format 
SHOW ROUTE [ destination | 
[ /FULL ] 
[ /GATEWAY=host ] 
[ /LOCAL ] 
[ /OUTPUT=file | 
[ /PERMANENT ] 
Restrictions 
Requires read access to the routes database. 
Parameters 
destination 
Optional. Default: Displays all routes. 
Destination host. 
Qualifiers 


/FULL 
Optional. Default: Displays routes as specified in the routes database. 


Displays mapping between destination addresses and names and gateway 
addresses and names. 


/GATEWAY=host 
Optional. Default: All gateways. 


Displays information for the specified host that performs as a gateway. 


/LOCAL 


Optional. Default: The command checks the hosts database; if a lookup fails, it 
checks the BIND resolver. 


Limits name-to-address lookups to the local hosts database. 
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SHOW ROUTE 


/OUTPUT=file 
Optional. Default: Screen display. 


Sends output to the specified file. 


/PERMANENT 
Optional. 


Displays only the permanent routes database. 


e If TCP/IP Services is running and you omit /PERMANENT, the volatile 
database is displayed. 


e If TCP/IP Services is not running, the permanent database is displayed. 


1. TCPIP> SHOW ROUTE 


DYNAMIC 
Type Destination Gateway 
AN 0.0.0.0 16.20.0.173 
AN 16.20.0.0/16 16.20.208.100 
AH 16.20.208.100 16.20.208.100 
AH 127.0.0.1 127.0.0.1 


Displays all defined routes. 


2. TCPIP> SHOW ROUTE "robin" 


Displays the network route to host robin. 
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SHOW SERVICE 


SHOW SERVICE 


Displays the following information about configured services: 


Service name 
Port for listening 
Protocol 

Process name 

IP address 

State 

RPC information 


Related commands: SET SERVICE, DISABLE SERVICE, ENABLE SERVICE 


Format 


SHOW SERVICE [ service ] 
[ /ADDRESS=adaress | 
[ /FULL ] 
[ PERMANENT ] 
[ /PORT=n ] 
[ /PROCESS=process | 
[ /PROTOCOL=protocol ] 
[ /RPC ] 


Parameters 


service 
Optional. Default: All services. 


Service for which you want information. 


Qualifiers 


/ADDRESS=address 
Optional. Default: All services. 


Displays information for only the services that use the specified address. 
/FULL 

Optional. Default: Brief description is displayed. 

Provides a full display. 

/PERMANENT 

Optional. 

Defaults: 


e If TCP/IP Services is running and you omit the /PERMANENT qualifier, the 
volatile database is displayed. 


e If TCP/IP Services is not running, the permanent database is displayed. 


You must include the /PERMANENT qualifier when you specify the /RPC 
qualifier. 


/PORT=n 
Optional. Default: All services. 
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Examples 


SHOW SERVICE 


Displays information only for services that use the specified port. 


/PROCESS=process 
Optional. Default: All services. 


Displays information for only the services that use the specified process. 


/PROTOCOL=protocol 
Optional. Default: All services. 


Displays information only for services that use the specified protocol. 


/RPC 
Optional. Default: No RPC information is displayed. 


Displays a brief summary of the services that are configured with RPC 
information. You must include the /PERMANENT qualifier when you specify 
the /RPC qualifier. 


1. TCPIP> SHOW SERVICE /RPC /PERMANENT 


RPC Protocol Versions 
Service Program Number Lowest / Highest 
MOUNT 100005 1 1 
NFS 100003 2 2 
PCNFS 150001 1 2 
PORTMAPPER 100000 2 2 


TCPIP> 


Displays all previously set RPC information. 


2. TCPIP> SHOW SERVICE NFS /FULL /PERMANENT 


Service: NFS 


Port: 2049 Protocol: UDP Address: 0.0.0.0 
Inactivity: 0 User_name: TCPIPSNFS Process: TCPIPS$NFS 
Limit: 1 

File: TCPIPSSYSTEM:TCPIPSNFS_RUN.COM 

Flags: TCPIP 

Socket Opts: Rcheck Scheck 

Receive: 64000 Send: 64000 
Log Opts: Acpt Actv Dactv Conn Error Exit Logi Mdfy Rjct TimO Addr 
File: SYSSSYSDEVICE: [TCPIPS$NFS]TCPIP$NFS_RUN.LOG 

RPC Opts 

Program number: 100003 Lowest version: 2 Highest version: 2 
Security 


Reject msg: not defined 
Accept host: 0.0.0.0 
Accept netw: 0.0.0.0 


TCPIP> 


The /FULL and /PERMANENT qualifiers display RPC information for the 
NFS server, whose program number is 100003, lowest version is 2, and 
highest version is 2. This information is required for the NFS server to run. 
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SHOW SERVICE 


3. TCPIP> SHOW SERVICE PCNFS /FULL /PERMANENT 


Service: PCNFS 


Port: 5151 Protocol: TCP,UDP Address: 0.0.0.0 
Inactivity: 0 User_name: TCPIP$PCNFS Process: TCPIPSPCNFSD 
Limit: 1 

File: TCPIPSSYSTEM: TCPIPSPCNFSD_RUN.COM 

Flags: TCPIP Prot 

Socket Opts: Rcheck Scheck 

Receive: 0 Send: 0 
Log Opts: Acpt Actv Dactv Conn Error Exit Logi Mdfy Rjct TimO Addr 
File: SYSSSYSDEVICE: [TCPIP$PCNFS ] TCPIP$PCNFSD_STARTUP.LOG 
RPC Opts 

Program number: 150001 Lowest version: 1 Highest version: 2 
Security 


efined 


Reject msg: not def 
0 
0 


d 
Accept host: 0.0.0 
Accept netw: 0.0.0 


Shows the full configuration in the permanent database for PC-NFS. The RPC 
information shows that PC-NFS runs as program 150001; its lowest version 
number is 1 and its highest version number is 2. 

4, TCPIP> SHOW SERVICE PORTMAPPER 
Service Port Protocol Process Address State 


PORTMAPPER 111 TCP, UDP TCPIPSPORTM 0.0.0.0 Enabled 


Monitors the Portmapper service process, showing that the service is enabled. 


5. TCPIP> SHOW SERVICE LBROKER /FULL /PERMANENT 
Service: LBROKER 


Port: 6570 Protocol: UDP Address: 0.0.0.0 
Inactivity: 0 User_name: TCPIPSLD BKR Process: TCPIPSLBROKER 
Limit: 1 

File: TCPIPSSYSTEM: TCPIPS$LBROKER_RUN.COM 

Flags: None 

Socket Opts: Rcheck Scheck 

Receive: 0 Send: 0 
Log Opts: Acpt Actv Dactv Conn Error Exit Logi Logo Mdfy Rjct TimO Addr 
File: SYSSSYSDEVICE: [TCPIP$LD BKR]TCPIP$LBROKER_RUN.LOG 

Security 


Reject msg: not defined 
Accept host: 0.0.0.0 
Accept netw: 0.0.0.0 


Displays the settings for cluster load balancing. 
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SHOW SERVICE 


TCPIP> SHOW SERVICE REXEC /FULL /PERMANENT 
Service: REXEC 


Port: 512 Protocol: TCP Address: 0.0.0.0 
Inactivity: 5 User_name: not defined Process: TCPIPSREXECD 
Limit: 3 
File: TCPIPSSYSTEM: TCPIPSREXEC_RUN.COM 
Flags: Case Listen Rexe TCPIP 
Socket Opts: Rcheck Scheck 
Receive: 0 Send: 0 
Log Opts: Acpt Actv Dactv Error Exit Mdfy Rjct TimO Addr 
File: TCPIPSREXEC.LOG 
Separators: 
Port: 0 User_name: 0 Password: 0 Command: 0 
Security 


Reject msg: not defined 
Accept host: 0.0.0.0 
Accept netw: 0.0.0.0 


Shows the full configuration in the permanent database for REXEC. 
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SHOW VERSION 


SHOW VERSION 


Displays the version of the TCP/IP Services software that is currently running, 
including individual components. 


Format 

SHOW VERSION [ /ALL ] 
Qualifiers 

/ALL 

Optional. Default: TCP/IP Services version. 

Displays the version of all running TCP/IP Services components. 
Examples 


1. TCPIP> SHOW VERSION 
HP TCP/IP Services for OpenVMS Alpha Version 5.4 
on an AlphaServer 1000 4/200 running OpenVMS V7.3-1 


Displays the following information: 

e Version of TCP/IP Services that is running. 
e Model of hardware platform. 

e Version of OpenVMS that is running. 
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START MAIL 


START MAIL 


Manually starts the SMTP sender queues (not the receiver [server]). 


Related commands: SHOW MAIL, ENABLE SERVICE SMTP, SHOW 
CONFIGURATION SMTP 


Format 
START MAIL 


Restrictions 
Requires SYSPRV or BYPASS privilege. 


SMTP consists of the sender and the receiver. Start the sender before you enable 
the receiver. 


Do not issue this command unless SMTP has been configured (with the SET 
CONFIGURATION SMTP command). 


Examples 
1. TCPIP> START MAIL 


Starts the SMTP sender. 


(To start the SMTP sender when TCP/IP Services starts up, see the SET 
CONFIGURATION ENABLE SERVICE command. To start the SMTP 
receiver, see the ENABLE SERVICE command.) 
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START ROUTING 


START ROUTING 


Format 


Qualifiers 


Examples 


Starts dynamic routing with ROUTED or GATED. If you want to change from one 
to the other, you must stop the current dynamic routing daemon then start the 
desired daemon. You cannot run both GATED and ROUTED at the same time. 


Related commands: STOP ROUTING, SET GATED 


START ROUTING [/GATED ] 
[ /LOG ] 
[ /SUPPLY[=DEFAULT] ] 


/GATED 
Optional. 


Enables the gateway routing daemon (GATED). 


If you enable dynamic GATED routing, you will be able to configure this host 
to use any combination of the following routing protocols to exchange dynamic 
routing information with other hosts on the network: 


e RIP (Routing Information Protocol), Versions 1 and 2 
e RDISC (Router Discovery Protocol) 

e OSPF (Open Shortest Path First) 

e EGP (Exterior Gateway Protocol) 

e BGP (Border Gateway Protocol), BGP-4 


e Static routes 


/SUPPLY[=DEFAULT] 
Optional. Applies only to ROUTED. Do not use with /GATED. 


Broadcasts routing information to other hosts in 30-second intervals. 


If you specify /SUPPLY=DEFAULT, the local host supplies the default network 
route. 


/LOG 
Optional. Applies to ROUTED. Do not use with /GATED. 


Logs routing activity to 
SYS$SYSDEVICE:[TCPIP$ROUTED]TCPIP$ROUTED.LOG. 


Default: No logging. 


1. TCPIP> START ROUTING /GATED 


Starts GATED dynamic routing on the running system. 


2. TCPIP> START ROUTING 


Interactively starts ROUTED dynamic routing on the running system. 


2-194 Command Descriptions 


START ROUTING 


3. TCPIP> START ROUTING /SUPPLY 


Immediately starts ROUTED dynamic routing. The local host both broadcasts 
and receives network routing information. 
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STOP ROUTING 


STOP ROUTING 


Stops dynamic routing. If GATED routing is used, stops dynamic routing but 
preserves GATED routes in the routing table. 


Use with SET NOROUTE when you require full manual control over the routing 
table. 


Related command: START ROUTING 


Format 

STOP ROUTING [/GATED ] 
Qualifiers 

/GATED 

Optional. 


Use to stop GATED dynamic routing and to remove all GATED routes from the 
routing table. 
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UNMAP 


UNMAP 


Makes unknown to the NFS server either a mapped (logically linked) OpenVMS 
disk or a container file system. 


Unmapping removes a logical file system, also called Network File System (NFS). 
Unmapped file systems are not accessible to remote users working on NFS clients. 


Related commands: MAP, SHOW MAP, SET CONFIGURATION NOMAP, 
ADD EXPORT, SHOW EXPORT, REMOVE EXPORT, MAP, UNMAP, SET 
CONFIGURATION MAP, SET CONFIGURATION NOMAP, SHOW MAP, SHOW 
CONFIGURATION MAP 


Applies to: NFS server 


Format 
UNMAP “/path/name" [ /[NO|JCONFIRM ] 


Restrictions 
Requires SYSPRV and BYPASS privilege. 


Parameters 


"/path/name" 
Required. 


UNIX name of the file system to unmap. 


You can use wildcards. 


Qualifiers 


/CONFIRM 
/NOCONFIRM 
Optional. Default: /CONFIRM if you use a wildcard. 


Requests confirmation before unmapping each file system. 


Examples 


1. TCPIP> UNMAP "/disk host" 


Unmaps the NFS file system /remote, making it unavailable to client users. 
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ZERO NFS_SERVER 


ZERO NFS_SERVER 


Resets the NFS server performance counters. 


Related commands: SET NFS_SERVER, SHOW NFS_SERVER 


Format 
ZERO NFS_SERVER _§ [ /HOST=host | 
[ SERVICES ] 
[| /USER_NAME=vms_user_name | 
Restrictions 
Requires SYSNAM and WORLD privileges. 


Qualifiers 


/HOST=host 
Optional. Default: All users, all hosts. 


With /USER_NAME, clears the counters relating to the specified users sharing 
the specified OpenVMS account. 


/SERVICES 
Optional. Default: NFS server services. 


Resets the counters for the NFS server and the Mount and Portmapper services. 


/USER_NAME=vms_user_name 
Optional. Default: All users, all hosts. 


With /HOST, clears the counters relating to the specified users sharing the 
specified OpenVMS account. 


Do not specify a list of names; specify only a single name. 
Examples 


1. TCPIP> ZERO NFS_SERVER /USER_NAME=NESTING /HOST="pigeon" 


Clears the NFS server counters for the remote NFS clients from host pigeon 
who use the OpenVMS account NESTING. 
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A 


Account, OpenVMS user 
creating, 2-5, 2-23 
deleting, 2-81 
displaying, 2-183 
ACP (ancillary control process) 
associating to process a volume, 2-69 
process buffer parameter, 2-65 
ADD EXPORT command, 2-2 
ADD PROXY command, 2-5 
Address 
0.0.0.0 
displaying device sockets, 2-159 
formats 
specifying, 1-2 
host-name-to-address lookups 
See Lookups 
IP 
defining, 2-97, 2-123 
displaying, 2-167 
mapping IP to Ethernet/FDDI, 2-84, 2-150 
Address Resolution Protocol 
See ARP 
Alias 
for defining a cluster, 2-98, 2-124 
ANALYZE CONTAINER command, 2-8 
ANALYZE MAIL command, 2-10 
ANALYZE SERVICE command, 2-13 
Anonymous FTP 


See FTP 
"ANY host" 
displaying device sockets, 2-159 
Applications 
customer-developed 
proxy database, 2-5 
registering clients, 2-5 
ARP 
displaying ARP information, 2-150 
setting address-mapping, 2-84 
Authentication 
proxy database, 2-5, 2-81 
AUTHORIZE command (DCL), 2-5 
Auxiliary server 
messages from, 2-146 
multithreading, 2-145 


Index 


Auxiliary server (cont'd) 
uses the BIND resolver, 2-105, 2-132 


Berkeley Internet Name Domain 


See BIND 
BG device driver 

See Internet interface 
BIND 4 

converting to BIND 8 configuration, 2-15 
BIND 8 

configuring, 2-90 

converting to, from BIND 4 configuration, 2-15 
BIND command 

See MAP command 
BIND database 

displaying, 2-164 


Binding 
See MAP command 
BIND resolver 
configuration 
displaying, 2-155 
configuring, 2-104, 2-130 
defining the domain, 2-104, 2-130 
deleting the domain, 2-104, 2-130 
disabling, 2-130 
displaying parameter settings, 2-164 
displaying the configuration, 2-176 
enabling, 2-131 
logging counters and statistics, 2-164 
BIND server 
configuration 
displaying, 2-155 
configuring, 2-90, 2-104 
CONVERT/CONFIGURATION BIND command, 
2-15 
CONVERT/UNIX BIND command, 2-16 
disabling, 2-43 
monitoring, 2-188 
reloading, 2-131 
Booting, remote 
See BOOTP 
BOOTP 
adding client entries, 2-86 
database 
adding entries to, 2-86 
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BOOTP 
database (cont’d) 
CONVERT/VMS BOOTP command, 2-20 
creating, 2-24 
displaying, 2-151 
disabling, 2-43 
enabling at system startup, 2-95 
monitoring, 2-188 
Bootstrap Protocol 
See BOOTP 
Buffers 
displaying, 2-153 
setting, 2-93 
setting ACP process parameter for, 2-65 


Cc 


Clients 

adding, to BOOTP database, 2-86 
Cluster alias 

defining, 2-98, 2-124 
Cluster load balancing 


See BIND server 
Commands 
See individual commands 
DCL 
AUTHORIZE, 2-5 
displaying information, 1-9 
guidelines for entering, 1-1 
preserving case, 1-3 
program design 
configuration commands, 1-5 
CONVERT commands, 1-7 
creating database files, 1-6 
managing NFS, 1-8 
starting software, 1-7 
stopping software, 1-7 
validating databases, 1-8 
specifying address formats, 1-2 
specifying file and directory names, 1-2 
specifying multiple values, 1-2 
specifying names and addresses, 1-2 
specifying numeric values, 1-3 
specifying service names, 1-2 
UNIX 
entering uppercase characters, 1-4 
/etc/mount command, 2-63 
using, 1-1 to 1-10 
how to enter, 1-1 
Communication proxies, 2-5 
APPLICATION_PROXY flag, 2-145 
Configuration 
BIND server 
creating, 2-90 
creating, 2-25 
database 
BIND server entries 
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Configuration 
database 
BIND server entries (cont’d) 
creating, 2-90 
creating, 2-25 
displaying, 2-155 
lower-layer software entries 
creating, 2-93 
lower-level protocol entries 
creating, 2-107 
name server entries 
creating, 2-104 
SMTP entries 
creating, 2-110 
SNMP entries 
creating, 2-114 
displaying, 2-155 
name server 
creating, 2-104 
permanent 
See individual SET CONFIGURATION 
commands 
SMTP 
creating, 2-110 
SNMP 
creating, 2-114 
Configuration protocol 
displaying, 2-158 
Controller 
Ethernet 
specifying interface name, 2-97, 2-124 
FDDI 
specifying interface name, 2-97, 2-124 
SLIP 
specifying interface name, 2-97, 2-124 
CONVERT/CONFIGURATION BIND command, 
2-15 
CONVERT/UNIX BIND command, 2-16 
CONVERT/UNIX HOST command, 2-18 
CONVERT/UNIX NETWORK command, 2-19 
CONVERT/VMS BOOTP command, 2-20 
CONVERT/VMS HOST command, 2-21 
CONVERT/VMS NETWORK command, 2-22 
CONVERT/VMS PROXY command, 2-23 
CREATE BOOTP command, 2-24 
CREATE CONFIGURATION command, 2-25 
CREATE CONTAINER command, 2-26 
CREATE DIRECTORY command, 2-29 
CREATE EXPORT command, 2-32 
CREATE HOST command, 2-33 
CREATE NETWORK command, 2-34 
CREATE PROXY command, 2-35 
CREATE ROUTE command, 2-36 
Customer-developed applications 
proxy database, 2-5 
registering clients, 2-5 


D 


Database 
BIND 
displaying, 2-164 
BIND server 
CONVERT/UNIX BIND command, 2-16 
BOOTP 
adding entries to, 2-86 
CONVERT/VMS BOOTP command, 2-20 
creating, 2-24 
displaying, 2-151 
configuration 
BIND server entries 
creating, 2-90 
creating, 2-25 
displaying, 2-155 
lower-layer software entries 
creating, 2-93 
lower-level protocol entries 
creating, 2-107 
name server entries 
creating, 2-104 
SMTP entries 
creating, 2-110 
SNMP entries 
creating, 2-114 
displaying SMTP routing information, 2-174 
export 
adding directory names in the export 
database, 2-2 
creating, 2-32 
deleting directory names from the export 
database, 2-76 
displaying, 2-162 
hosts 
cluster alias 
specifying, 2-98, 2-124 
CONVERT/UNIX HOST command, 2-18 
CONVERT/VMS HOST command, 2-21 
displaying, 2-164 
MX 
adding information to, 2-128 
displaying SMTP routing information, 
2-174 
networks 
adding entries, 2-133 
CONVERT/UNIX NETWORK command, 
2-19 
CONVERT/VMS NETWORK command, 
2-22 
displaying entries, 2-178 
proxy 
adding entries to, 2-5, 2-23 
creating, 2-35 
deleting entries from, 2-81 
displaying, 2-183 


Database (cont’d) 
routes 
adding MX information, 2-128 
creating, 2-36 
displaying SMTP routing information, 
2-174 
services 
displaying, 2-188 
setting entries in, 2-143 
verifying integrity of definitions, 2-13 
Data link 
See Internet interface 
Data link interface 
See Internet interface 
DCL 
AUTHORIZE command, 2-5 
Defense Data Network 
See DDN 
DEFINE COMMUNICATION_CONTROLLER 
command, 2-37 
DELETE COMMUNICATION_CONTROLLER 
command, 2-39 
DELETE CONTAINER command, 2-40 
Device driver 
Internet, 2-97, 2-123, 2-167 
Device socket 
displaying information, 2-159 
DIRECTORY command, 2-41 
Directory names 
specifying, 1-2 
DISABLE SERVICE command, 2-43 
DISCONNECT DEVICE_SOCKET command, 
2-45 
DISMOUNT command, 2-46 
DNFSn: 
See NFS 
DNS 
See BIND 
Domain 
served by BIND, configuring, 2-90 
Domain Name System 
See BIND, DNS 
Dynamic routing 
See Routing 


E 


ENABLE SERVICE command, 2-49 
Error logging 
See Event logging 
ETC.BOOTPTAB file 
CONVERT/VMS BOOTP command, 2-20 
/etc/hosts file 
CONVERT/UNIX HOST command, 2-18 
CONVERT/VMS HOST command, 2-21 
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/etc/mount command, 2-63 
/etc/networks file 
CONVERT/UNIX NETWORK command, 2-19 
CONVERT/VMS NETWORK command, 2-22 
Ethernet 
address 
mapping to IP, 2-84, 2-150 
controller 
specifying interface name, 2—97, 2-124 
Exchange identification 
See XID 
EXIT command, 2-51 
EXPORT command, 2-52 
Export database 
adding directory names in the export database, 
2-2 
creating, 2-32 
deleting directory names from the export 
database, 2-76 
displaying, 2-162 


F 


FDDI 
address 
mapping to IP, 2-84, 2-150 
controller 
specifying interface name, 2—97, 2-124 
FDDI controller 
See Network device 
Fiber Distributed Data Interface 
See FDDI 
File names 
specifying, 1-2 
Files-11 On-Disk Structure 
See ODS-2, ODS-5 
File system 
See NFS 
File Transfer Protocol 
See FTP 
FTP 
disabling, 2-43 
enabling at system startup, 2-95 
monitoring, 2-188 


G 


Gateway Protocol routing, 2-120 


H 


Hardware 
Internet interface, 2—97 
platform model, 2-192 
Hardware address, 1-2 
mapping to IP address, 2-84 


Index-—4 


HELP command, 2-53 
Host 
entry in hosts database, 2-121 
name-to-address lookups 
See Lookups 
Host address 
defining, 2-97, 2-123 
displaying, 2-167 
Hosts database 
cluster alias 
specifying, 2-98, 2-124 
CONVERT/UNIX HOST command, 2-18 
CONVERT/VMS HOST command, 2-21 
displaying, 2-164 


ICMP 
ECHO packets 
for testing, 2-59, 2-73 
setting parameters in configuration database, 
2-107 
setting parameters on running system, 2-137 
IMPORT command, 2-54 
INET_ACP 
setting parameters in configuration database, 
2-93 
setting parameters on running system, 2-88 
Interface 
See Internet interface 
Internet 
device driver, 2-97, 2-123, 2-167 
Internet Control Message Protocol 


See ICMP 
Internet interface 
cluster broadcast mask 
defining, 2-98, 2-124 
cluster network mask 
defining, 2-98, 2-124 
defining, 2-97 
defining an IP alias, 2-123 
defining broadcast address for, 2-98, 2-124 
displaying, 2-167 
new device 
defining, 2-37 
deleting, 2-39 
displaying, 2-57 
pseudointerface 
defining, 2-97 
displaying, 2-167 
testing, 2-100, 2-126 
Internet Protocol 
See IP 
IP 
address 
mapping to Ethernet, 2-84, 2-150 


IP (cont’d) 
setting parameters in configuration database, 
2-93, 2-107 
setting parameters on running system, 2-88, 
2-137 
starting, 2-93 


L 


LIST COMMUNICATION_CONTROLLER 
command, 2-57 
Load balancing 
See BIND server 
Logging 
See Event logging 
Lookups 
by BIND resolver, 2-131, 2-186 


in hosts database, 2-130, 2-150, 2-151, 2-160, 


2-165, 2-186 

using BIND resolver, 2-104 

using hosts database, 2-104 
LOOP command, 2-59 
LPD 

disabling, 2-43 

enabling at system startup, 2-95 

monitoring, 2-188 

proxy database, 2-5 

registering clients, 2-5 


M 


Mail 
See SMTP 
Mail Exchange 
See SMTP, MX database 
MAP command, 2-61 
Mapping 
file system to NFS server 
See MAP command, NFS 
name to address 
See Lookups 
Master file directory 
See MFD 
MFD 
specifying, 2-68 
MOUNT command, 2-63 
Mounting 
displaying mounted file systems, 2-172 
mount point 
specifying, 2-64 
remote directories, 2—63 
Mount point 
dismounting, 2—46 
specifying, 2-64, 2-68 
MX 
See MX database, SMTP 


MX database 
routing mail 
displaying, 2-174 
setting, 2-128 


N 


Name service 
See DNS 
Name-to-address lookups 
See Lookups 
Network 
name-address lookups 
displaying, 2-178 
setting, 2-133 
Network management 
See individual topics 
remote 
See SNMP 
Network print services 
See Printing 
Networks database 
adding entries, 2-133 
CONVERT/UNIX NETWORK command, 2-19 
CONVERT/VMS NETWORK command, 2-22 
displaying entries, 2-178 
NFS 
client 
dismounting remote file system, 2-46 
displaying mounted directories, 2—172 
enabling at system startup, 2-95 
mounting remote file system, 2-63 
mount point, 2-68 
dismounting, 2-46 
specifying, 2-64 
proxy database, 2-5, 2-23 
registering clients, 2-5 
PC clients 
See PC-NFS 
proxies, 2-5 
server 
adding directory names in the export 
database, 2-2 
copying container directory files to 
OpenVMS files, 2-52 
copying OpenVMS files to container 
directory files, 2-54 
counters 
displaying, 2-179 
resetting, 2-198 
creating proxy database, 2-35 
deleting container file system, 2-40 
deleting directory names from the export 
database, 2-76 
directories 
creating, 2-29 
displaying counters and statistics, 2-179 
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NFS 
server (cont'd) 
displaying export database, 2-162 
displaying files in UNIX container 
directory, 2-41 
displaying proxy database, 2-183 
enabling at system startup, 2-95 
export database, 2-32 
links 
creating, 2-29 
deleting, 2-75, 2-78 
making files available for mounting, 2-61, 
2-102 
making files unavailable, 2-106 
making files unavailable to, 2-197 
mapping 
displaying, 2-171 
mapping files or disks to, 2-61 
mapping file systems, 2-102 
displaying, 2-155 
making unavailable, 2-197 
NFS clients 
making files unavailable to, 2-197 
parameters 
displaying, 2-179 
setting, 2-135 
performance 
monitoring, 2-179 
resetting counters, 2-198 
setting parameters, 2-135 
proxy database, 2-5, 2-23, 2-81 
registering clients, 2-5 
removing a link to a file, 2-78 
removing links to a directory, 2-75 
showing clients, 2-183 
UNIX file system 
creating, 2-26 
unmapping file systems, 2-106 
unregistering clients, 2-81 
verifying UNIX container file, 2-8 
NFS client 
See NFS 
NFS server 
See NFS 
Numeric values 
specifying, 1-3 


O 


ODS-2 volume 
format, 2—70 
label, 2-64 

ODS-5 volume 
format, 2—70 
label, 2-64 

ONC 
See RPC 
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Online help 
HELP command, 2-53 
Open Network Computing (ONC) 
See RPC 
OpenVMS Cluster 
broadcast mask 
defining, 2-98, 2-124 
displaying Internet interface information, 
2-167 
network mask 
defining, 2-98, 2-124 
SMTP queues, 2-112 


P 


PC-NFS 
See also Printing 
disabling, 2-43 
enabling system startup, 2-95 
monitoring, 2-188 
proxy database, 2-5 
registering clients, 2-5 
PC-NFSd 
See PC-NFS 
Performance 
See also Troubleshooting 
NFS server 
monitoring, 2-179 
resetting counters, 2-198 
setting parameters, 2-135 
PING command, 2-73 
PORTMAPPER 
disabling, 2-43 
displaying, 2-180 
enabling at system startup, 2-95 
monitoring, 2-188 
Printing 
See also LPD, LPR, PC-NFS 
LPD 
disabling, 2-43 
monitoring, 2-188 
Problem solving 


See Troubleshooting 
Protocol 
See also individual protocols 
configuring 
in configuration database, 2-107 
on running system, 2-137 
ICMP 
configuring in configuration database, 
2-107 
configuring on running system, 2-137 
displaying configuration, 2-158 
sending ECHO packets, 2-59, 2-73 
IP 
configuring in configuration database, 
2-107 


Protocol 
IP (cont’d) 
configuring on running system, 2-137 
displaying configuration, 2-158 
starting, 2-93 
TCP 
configuring in configuration database, 
2-107 
configuring on running system, 2-137 
displaying configuration, 2-158 
starting, 2-93 
UDP 
configuring in configuration database, 
2-107 
configuring on running system, 2-137 
displaying configuration, 2-158 
starting, 2-93 
Proxy 
database 
adding entries to, 2-5, 2-23 
creating, 2-35 
deleting entries from, 2-81 
displaying, 2-183 
displaying, 2-183 
removing entries from database, 2-81 
Pseudointerface 
See Internet interface 


R 


Record Management Services 

See RMS 
Remote booting 

See BOOTP 
Remote procedure call 

See RPC 
Remote shell 

disabling, 2—43 

enabling at system startup, 2-95 

monitoring, 2-188 

registering clients, 2-5 
REMOVE DIRECTORY command, 2-75 
REMOVE EXPORT command, 2-76 
REMOVE FILE command, 2-78 
REMOVE MAIL command, 2-79 
REMOVE PROXY command, 2-81 
Resolver 

See BIND 
Reverse lookups 


See Lookups 
Reverse mapping 
See Lookups 
REXEC 
enabling at system startup, 2-95 
monitoring, 2-188 


RIP 
See Routing 
RLOGIN 
disabling, 2-43 
enabling at system startup, 2-95 
monitoring, 2-188 
RMS 
sequential access, 2-67 
Routes database 
adding MX information, 2-128 
creating, 2-36 
displaying SMTP routing information, 2-174 
Routing 
configuring, 2-140 
creating database, 2-36 
displaying, 2-153 
displaying routes, 2-186 
displaying SMTP routing information, 2-174 
dynamic 
defining path, 2-140 
Gateway protocol routing, 2-120 
MX information, 2-128 
starting, 2-194 
upon TCP/IP Services startup, 2-119 
static 
defining path, 2-140 
stopping, 2-196 
Routing Information Protocol (RIP) 
See Routing 
Routing tables 


See Routing 
RPC 
displaying, 2-180 
displaying information used by Portmapper, 
2-188 
RSH 
See Remote shell 


S 


Security 
CREATE PROXY command, 2-385 
proxy database, 2-5, 2-81 
SEND MAIL command, 2-83 
Services 
database 
displaying, 2-155, 2-188 
setting entries in, 2-143 
troubleshooting, 2-13 
disabling, 2-43 
displaying, 2-155 
displaying configuration information, 2-155 
displaying protocol configuration information, 
2-158 
displaying settings and status of, 2-153 
enabling 
at system startup, 2-95 
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Services 
enabling (cont'd) 
interactively, 2-49 
names, 1-2 
setting communication properties of, 2-88, 
2-93 
SET ARP command, 2-84 
SET BOOTP command, 2-86 
SET COMMUNICATION command, 2-88 
SET CONFIGURATION BIND command, 2-90 
SET CONFIGURATION COMMUNICATION 
command, 2-93 
SET CONFIGURATION ENABLE SERVICE 
command, 2-95 
SET CONFIGURATION INTERFACE command, 
2-97 
SET CONFIGURATION MAP command, 2-102 
SET CONFIGURATION NAME_SERVICE 
command, 2-104 
SET CONFIGURATION PROTOCOL command, 
2-107 
SET CONFIGURATION SMTP command, 2-110 
SET CONFIGURATION SNMP command, 2-114 
SET CONFIGURATION START ROUTING 
command, 2-119 
SET GATED command, 2-120 
SET HOST command, 2-121 
SET INTERFACE command, 2-123 
SET MX_RECORD command, 2-128 
SET NAME_SERVICE command, 2-130 
SET NETWORK command, 2-133 
SET NFS_SERVER command, 2-135 
SET PROTOCOL command, 2-137 
SET ROUTE command, 2-140 
SET SERVICE command, 2-143 
SHOW ARP command, 2-150 
SHOW BOOTP command, 2-151 
SHOW COMMUNICATION command, 2-153 
SHOW CONFIGURATION command, 2-155 
SHOW CONFIGURATION PROTOCOL command, 
2-158 
SHOW DEVICE_SOCKET command, 2-159 
SHOW EXPORT command, 2-162 
SHOW HOST command, 2-164 
SHOW INTERFACE command, 2-167 
SHOW MAIL command, 2-169 
SHOW MAP command, 2-171 
SHOW MOUNT command, 2-172 
SHOW MX_RECORDS command, 2-174 
SHOW NAME_SERVICE command, 2-176 
SHOW NETWORK command, 2-178 
SHOW NFS_SERVER command, 2-179 
SHOW PORTMAPPER command, 2-180 
SHOW PROTOCOL command, 2-181 
SHOW PROXY command, 2-183 
SHOW ROUTE command, 2-186 
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SHOW SERVICE command, 2-188 
SHOW VERSION command, 2-192 
Simple Mail Transfer Protocol 
See SMTP 
Simple Network Management Protocol 
See SNMP 
SLIP controller 


specifying interface name, 2-97, 2-124 


SMTP 
See also MX database 
8-bit characters, 2-111 
configuration 
displaying, 2-155 


deleting messages from queues, 2-79 


disabling, 2-43 
displaying queue information, 2-169 


displaying routing information for, 2-174 


enabling at system startup, 2-95 
headers, 2-111 
monitoring, 2-188 
MX information, 2-128 
options 
8-bit characters, 2-111 
headers, 2-111 
queue management, 2-79 
queues 
OpenVMS Cluster nodes, 2-112 
reconfiguring, 2-110 
requeuing mail, 2-83 
starting sender queues, 2-193 
verifying consistency of queues, 2-10 
SNMP 
configuration 
creating, 2-114 
displaying, 2-155 
disabling, 2-43 
enabling at system startup, 2-95 
monitoring, 2-188 
Software version 
displaying, 2-192 
START MAIL command, 2-193 
START ROUTING command, 2-194 
Static routing 
See Routing 
STOP ROUTING command, 2-196 
Subnetworking 
See Routing 
Subnetwork routing 
See Routing 


Sun RPC 
See RPC 


T 


TCP 
setting parameters in configuration database, 
2-93, 2-107 
setting parameters on running system, 2-88, 
2-137 
starting, 2-93 
TELNET 
disabling, 2-43 
enabling at system startup, 2-95 
monitoring, 2-188 
print symbiont 
See Printing 
TELNETSYM 
See Printing 
Terminal emulation 
of IBM 3270 model terminals 
See TELNET 
Testing 
for active connectivity 
LOOP command, 2-59 
PING command, 2-73 
Internet interface, 2-100, 2-126 
TFTP 
disabling, 2-43 
enabling at system startup, 2-95 
monitoring, 2-188 
TIME 
configuration 
displaying, 2-155 
TN3270 
See TELNET 
Transmission Control Protocol/Internet Protocol 
See TCP/IP 
Trivial File Transfer Protocol 
See TFTP 
Troubleshooting 
Internet controller, 2-39 
NFS server 
ANALYZE CONTAINER command, 2-8 
services database, 2-13 
SMTP 
ANALYZE MAIL command, 2-10 


U 


UDP 
setting parameters in configuration database, 
2-93, 2-107 
setting parameters on running system, 2-88, 
2-137 
starting, 2-93 
UIC 


container directories 


copying into with IMPORT command, 2-56 


UIC (cont’d) 
specifying with CREATE CONTAINER 
command, 2-26 
specifying with CREATE DIRECTORY 
command, 2-30 
UNIX 
container file 
verifying integrity of, 2-8 
converting BIND database to forward or reverse 
translation file, 2-16 
converting hosts database to hosts file for UNIX 
system, 2-18 
converting networks database to file formatted 
for use on UNIX system, 2-19 
/etc/mount command, 2-63 
UNIX file system 
creating, 2-26 
UNIX commands 
entering uppercase characters, 1-4 
using, 1-9 
UNIX-style files 
See NFS 
UNMAP command, 2-197 
User Datagram Protocol 
See UDP 
User identification code 
See UIC 


V 


Version 
displaying, 2-192 


X 


XID 
counters, 2-179 


Y 


Yellow Pages 
creating file format, 2-18 


Z 


ZERO NFS_SERVER command, 2-198 
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